Case study
magicJack HOME: a Linux phone system from USB and SIP protocol research
magicJack HOME is investigated through its vendor macOS driver, USB register interface and captured SIP traffic to build a Linux-controlled analog phone endpoint. Python tools drive line power, ringing, hook detection and DTMF over hidraw, while baresip and a bridge connect the handset to a self-hosted PBX. The author reports live two-way calls on the resulting setup.
- Targets
- Binary · Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C2 code & docs, no demo or download
- Stars
- 6
- Last commit
- 2026-07-17
- Language
- Python
GitHub data as of 2026-11-10
Evidence
- Observed
- Code and documentation observed; no download method or demo found.
- Checked
- 2026-11-08
Requirements & limits
- Prerequisites: A magicJack HOME, Linux host, analog phone and SIP PBX are needed for the documented setup.
- Limits: The account's session-keyed SIP configuration was not recovered.
- License: MIT license.
Cite
BibTeX
@misc{magicjack-home-linux-phone-case,
title = {{magicJack HOME: a Linux phone system from USB and SIP protocol research}},
howpublished = {\url{https://github.com/Gbrothers1/magicjack-hacking}},
url = {https://github.com/Gbrothers1/magicjack-hacking},
urldate = {2026-11-06},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/magicjack-home-linux-phone-case/}}
}Plain text
magicJack HOME: a Linux phone system from USB and SIP protocol research. https://github.com/Gbrothers1/magicjack-hacking (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/magicjack-home-linux-phone-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- README.md GitHub · Gbrothers1/magicjack-hacking · Revision 8673832
- 02-cisco-1841/magicjack-sip-notes.md GitHub · Gbrothers1/magicjack-hacking · Revision 8673832
More in Protocols
- PyKS2: reconstructing the Pentax K-S2 Wi-Fi API · Case study
- ESPHome — Maytronics Air Cover BLE: reconstructing pool-cover control · Case study
- RevCar CLI: reconstructing WowWee car BLE control · Case study
- Open Steigen: documenting an appliance's local protocol · Case study
- Tchibo 287717: decoding a wireless weather-sensor signal · Case study
- BPM: USB data access for the Aponorm blood pressure monitor · Case study