portapack-mayhem /mayhem-firmware

The firmware for the HackRF+PortaPack H1/H2/H4/H4M

★ 5,544⑂ 951👁 226⑃ 1,679● 1,389▤ 768
CGPL-3.0Created 2020-03-29hackrf.app
下载:Mayhem firmware v2.4.0Mayhem-2.4.0 ↓2.4.02026-03-24
5,544
stars
951
forks
226
watchers
1,679
prs
1,389
issues
768
releases

README

[!WARNING]
 __IF YOU'VE PAID FOR MAYHEM OR ANY PREPACKAGED VERSIONS, YOU'RE BEING SCAMMED.__ 

 The only legitimate link to our repositories is the portapack-mayhem organization on GitHub.---
 PortaPack Mayhem

     

This is a fork of the Havoc firmware, which itself was a fork of the PortaPack firmware, an add-on for the HackRF. A fork is a derivate, in this case one that has extra features and fixes when compared to the older versions.

 



 What is this?


If you are new to HackRF+PortaPack+Mayhem, check these:









 Frequently Asked Questions

This repository expands upon the previous work by many people and aims to constantly add new features, bugfixes and generate documentation to make further development easier.  Collaboration is always welcomed and appreciated.

 What to buy?

 
:heavy_check_mark: !Static Badge The fabulous H4M complete or upgrade, featuring numerous improvements and accessories. Sold by our friends at OpenSourceSDRLab. Join their giveaways on discord (check the badge on top). _EU customers_ can purchase via Lab401.

:heavy_check_mark: A recommended one is this PortaPack H2, that includes everything you need with the plastic case "inspired" on this.

:heavy_check_mark: Some individuals lean towards the H2 with a metal enclosure, but its advantages remain debated. Share your insights on our wiki. 

:warning: Be cautious , ask the seller about compatibility with the latest releases. Look out for the description of the item, if they provide the firmware files for an older version or they have custom setup instructions, this means it might be NOT compatible, for example:

!image

:warning: If it looks too different, this might mean that they are using their own recipe, check the different models in our wiki. For example all the H3 and clones of that version use their own version of the firmware. They do not contribute the changes back and eventually you will be left with a device that nobody maintains:

!image

 Where is the latest version?

The current stable release is on the  page. Follow the instructions you can find in the release description. The latest (nightly) release can be found here.

 How can I collaborate


We warmly welcome your contributions! Please refer to our Contributing Guidelines for details.

You can write documentation, fix bugs and answer issues or add new functionality. Please also check the following guide with details.

Consider that the hardware and firmware has been created and maintain by a lot of people, so always try collaborating your time and effort first. For coding related questions, if something does not fit as an issue, please join our Discord by clicking the chat badge on top.



To support the people behind the hardware, please buy a genuine HackRF and PortaPack.

 What if I really want something specific?
If what you need can be relevant in general, you can request a feature. Alternatively, go to our Discord by clicking the chat badge on top and discuss there.

 What if I need h

Top issues

Latest release

Mayhem firmware v2.4.0 v2.4.0 2026-03-24
Stable release - v2.4.0

 🆕 HackRF Pro (PRALINE) Support
Mayhem now officially supports the HackRF Pro! This includes iCE40 FPGA bitstream loading, MAX2831 transceiver driver, software RSSI, and dedicated diagnostic views. ⚠️ HackRF Pro support is still a work in progress — while a lot works great, there are still some bugs we're actively working on.

- @stafur: Initial HackRF Pro architecture port (2958, 2991, 3018, 3030, 3031, 3039, 3048, 3049, 3052, 3053, 3054, 3057, 3058, 3068, 3077, 3080, 3091)
- @bumblebee-2025: Fix RX audio baseband async error for PRALINE (3010), pin mux fix (308

Snapshot: 2026-11-17T10:29:19Z · Data license Apache-2.0 · JSON