# 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.

- Type: Case study
- Targets: Binary · Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/Gbrothers1/magicjack-hacking>
- Primary source: <https://github.com/Gbrothers1/magicjack-hacking/blob/8673832ef7597b8ff30dc1299a8242bddd53d370/README.md>
- Catalog page: <https://awesomerea.org/resources/magicjack-home-linux-phone-case/>
- Record JSON: <https://awesomerea.org/resources/magicjack-home-linux-phone-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/magicjack-home-linux-phone-case/index.md)

## 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.

## Primary sources

1. <https://github.com/Gbrothers1/magicjack-hacking/blob/8673832ef7597b8ff30dc1299a8242bddd53d370/README.md>
2. <https://github.com/Gbrothers1/magicjack-hacking/blob/8673832ef7597b8ff30dc1299a8242bddd53d370/02-cisco-1841/magicjack-sip-notes.md>

## More in Protocols

- [PyKS2: reconstructing the Pentax K-S2 Wi-Fi API](https://awesomerea.org/resources/pyks2-case/index.md) · Case study
- [ESPHome — Maytronics Air Cover BLE: reconstructing pool-cover control](https://awesomerea.org/resources/maytronics-aircover-esphome-case/index.md) · Case study
- [RevCar CLI: reconstructing WowWee car BLE control](https://awesomerea.org/resources/revcar-cli-case/index.md) · Case study
- [Open Steigen: documenting an appliance's local protocol](https://awesomerea.org/resources/open-steigen-protocol-case/index.md) · Case study
- [Tchibo 287717: decoding a wireless weather-sensor signal](https://awesomerea.org/resources/tchibo-287717-weather-signal-case/index.md) · Case study
- [BPM: USB data access for the Aponorm blood pressure monitor](https://awesomerea.org/resources/bpm-aponorm-usb-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.