M5 Crystal

Pentest View the repo

M5 Crystal is a multifunctional firmware for M5Stack devices that combines pentesting capabilities—such as Wi‑Fi attacks, Bluetooth scanning, NFC read/write, IR control, and BadUSB—with everyday utilities like file management, web server, and customizable settings, all presented in a multilingual interface.

auto-summary

84 stars · 3 forks

Maintainer
Dlazder
Distribution
m5burnerreleases
Capabilities
wifiblenfcir
Chip families
esp32esp32-s3

Runs on these boards

Known good

  • StickC-Plus2Known goodM5StackM5Burner
    Flash StickC-Plus2M5Burnerknown-good

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

  • M5StickS3Known goodM5StackM5Burner
    Flash M5StickS3M5Burnerknown-good

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

README

��#� �M�5��C�R�Y�S�T�A�L� � �A� �m�u�l�t�i�f�u�n�c�t�i�o�n�a�l� �f�i�r�m�w�a�r�e� �f�o�r� �p�e�n�t�e�s�t�i�n�g� �a�n�d� �e�v�e�r�y�d�a�y� �u�s�e�.� �B�u�i�l�t� �f�o�r� �M�5�S�t�a�c�k� �d�e�v�i�c�e�s�,� �a�l�l� �i�n� �a� �c�l�e�a�n� �a�n�d� �s�t�a�b�l�e� �c�o�d�e�b�a�s�e� �f�o�c�u�s�e�d� �o�n� �s�i�m�p�l�i�c�i�t�y� �a�n�d� �e�x�t�e�n�s�i�b�i�l�i�t�y�.� � �<�i�m�g� �s�r�c�=�"�.�/�i�m�a�g�e�s�/�p�r�e�v�i�e�w�.�p�n�g�"� �w�i�d�t�h�=�"�8�0�0�"� �a�l�t�=�"�F�i�r�m�w�a�r�e� �p�r�e�v�i�e�w�"�/�>� � �#�#� �F�e�a�t�u�r�e�s� � �-� �W�i�-�F�i�:� �s�c�a�n�n�e�r�,� �d�e�a�u�t�h�,� �W�P�A� �b�r�u�t�e�f�o�r�c�e�,� �h�a�n�d�s�h�a�k�e� �c�a�p�t�u�r�e�,� �e�v�i�l� �t�w�i�n�,� �e�v�i�l� �p�o�r�t�a�l�,� �W�P�S� �P�B�C�,� �w�e�b� �s�e�r�v�e�r�,� �c�h�a�n�n�e�l� �a�n�a�l�y�z�e�r�,� �w�e�a�t�h�e�r�,� �t�i�m�e� �s�y�n�c�,� �w�i�f�i� �i�n�f�o�,� �w�i�f�i� �c�o�n�n�e�c�t�,� �p�a�s�s�w�o�r�d� �s�a�v�e� �-� �B�l�u�e�t�o�o�t�h�:� �B�L�E� �S�c�a�n�,� �B�A�D� �B�L�E�,� �s�n�i�f�f�e�r�,� �d�e�v�i�c�e� �f�i�n�d�e�r�,� �g�y�r�o� �m�o�u�s�e�,� �g�y�r�o� �k�e�y�b�o�a�r�d�,� �p�r�e�s�e�n�t�e�r�,� �p�h�o�n�e� �c�a�m�e�r�a� �s�h�u�t�t�e�r�,� �m�o�u�s�e� �j�i�g�g�l�e�r� �-� �N�F�C�:� �r�e�a�d� �a�n�d� �w�r�i�t�e� �U�I�D�,� �t�a�g� �i�n�f�o� �(�P�N�5�3�2� �m�o�d�u�l�e�)� �-� �I�R�:� �r�e�a�d� �s�i�g�n�a�l�,� �s�a�v�e� �s�i�g�n�a�l� �t�o� �l�i�t�t�l�e�F�S�,� �s�e�n�d� �s�i�g�n�a�l�,� �T�V�-�B�-�G�o�n�e� �-� �U�S�B�:� �B�A�D� �U�S�B�,� �m�o�u�s�e� �j�i�g�g�l�e�r�,� �a�i�r� �m�o�u�s�e�,� �k�e�y�b�o�a�r�d�,� �m�a�s�s� �s�t�o�r�a�g�e� �m�o�d�e� �-� �F�i�l�e�s�:� �c�r�e�a�t�e�,� �e�d�i�t�,� �d�e�l�e�t�e�,� �r�e�n�a�m�e� �a�n�d� �f�i�l�e�s� �i�n� �s�d� �c�a�r�d� �a�n�d� �l�i�t�t�l�e�F�S�.� �-� �U�A�R�T� �t�e�r�m�i�n�a�l�:� �r�e�c�i�e�v�i�n�g� �a�n�d� �s�e�n�d�i�n�g� �t�e�x�t�.� �b�a�u�d� �r�a�t�e� �a�n�d� �p�i�n�s� �s�e�t�t�i�n�g�s� �-� �S�e�t�t�i�n�g�s�:� �l�a�n�g�u�a�g�e�,� �t�i�m�e�,� �t�i�m�e�z�o�n�e�,� �r�o�t�a�t�i�o�n�,� �c�o�l�o�r�s�,� �b�r�i�g�h�t�n�e�s�s�,� �s�t�a�t�u�s� �b�a�r�,� �s�t�a�r�t�u�p� �s�o�u�n�d�,� �k�e�y�b�o�a�r�d� �g�y�r�o�,� �s�c�r�e�e�n� �d�i�m�m�i�n�g�,� �w�e�b� �s�e�r�v�e�r� �F�S� �m�o�d�e� �-� �O�t�h�e�r�:� �c�l�o�c�k�,� �f�l�a�s�h�l�i�g�h�t�,� �b�a�t�t�e�r�y�,� �l�e�v�e�l� �t�o�o�l�,� �s�o�u�n�d� �m�e�t�e�r�,� �s�y�s�t�e�m� �i�n�f�o� �-� �1�2� �L�a�n�g�u�a�g�e�s�:� �E�n�g�l�i�s�h�,� �F�r�e�n�c�h�,� �G�e�r�m�a�n�,� �P�o�r�t�u�g�u�e�s�e�,� �T�u�r�k�i�s�h�,� �I�t�a�l�i�a�n�,� �S�p�a�n�i�s�h�,� �I�n�d�o�n�e�s�i�a�n�,� �R�u�s�s�i�a�n�,� �U�k�r�a�i�n�i�a�n�,� �P�o�l�i�s�h�,� �R�o�m�a�n�i�a�n� �-� �D�e�v�i�c�e�s�:� �M�5�S�t�i�c�k�C�P�l�u�s�2�,� �M�5�S�t�i�c�k�S�3�,� �C�a�r�d�p�u�t�e�r�-�A�D�V� �(�C�a�r�d�p�u�t�e�r� �v�1�.�1�)� �-� �M�o�d�u�l�e�s�:� �P�N�5�3�2�,� �S�D�,� �I�R� �r�e�c�i�e�v�e�r�.� � �#�#� �I�n�s�t�a�l�l�a�t�i�o�n� � �Y�o�u� �c�a�n� �i�n�s�t�a�l�l� �t�h�e� �f�i�r�m�w�a�r�e� �f�r�o�m� �m�5�b�u�r�n�e�r� �o�r� �f�l�a�s�h� �i�t� �y�o�u�r�s�e�l�f� �(�b�y� �d�o�w�n�l�o�a�d�i�n�g� �t�h�e� �b�i�n�a�r�y� �f�i�l�e� �f�i�r�s�t� �o�r� �c�o�m�p�i�l�i�n�g� �i�t� �y�o�u�r�s�e�l�f�)�.� �A�l�l� �c�o�m�p�i�l�a�t�i�o�n� �m�e�t�h�o�d�s� �a�r�e� �d�e�s�c�r�i�b�e�d� �i�n� �d�e�t�a�i�l� �i�n� �t�h�e� �d�o�c�u�m�e�n�t�a�t�i�o�n�.� � �<�!�-�-� �#�#� �G�e�t� �l�a�t�e�s�t� �b�u�i�l�d� � �D�o�w�n�l�o�a�d� �t�h�e� �f�i�r�m�w�a�r�e� �f�i�l�e� �a�n�d� �[�f�l�a�s�h� �i�t�]�(�.�/�d�o�c�s�/�f�l�a�s�h�.�m�d�)� � �[�!�[�L�a�t�e�s�t� �R�e�l�e�a�s�e�]�(�h�t�t�p�s�:�/�/�i�m�g�.�s�h�i�e�l�d�s�.�i�o�/�g�i�t�h�u�b�/�v�/�r�e�l�e�a�s�e�/�D�l�a�z�d�e�r�/�m�5�s�t�i�c�k��c�r�y�s�t�a�l��f�i�r�m�w�a�r�e�?�s�t�y�l�e�=�f�l�a�t�-�s�q�u�a�r�e�&�l�a�b�e�l�=�l�a�t�e�s�t�%�2�0�b�u�i�l�d�)�]�(�h�t�t�p�s�:�/�/�g�i�t�h�u�b�.�c�o�m�/�D�l�a�z�d�e�r�/�m�5�s�t�i�c�k��c�r�y�s�t�a�l��f�i�r�m�w�a�r�e�/�r�e�l�e�a�s�e�s�/�l�a�t�e�s�t�)� �-�-�>� � �#�#� �D�o�c�u�m�e�n�t�a�t�i�o�n� � �-� �[�B�u�i�l�d� �f�i�r�m�w�a�r�e� �a�n�d� �f�l�a�s�h� �(�a�l�l� �m�e�t�h�o�d�s�)�]�(�.�/�d�o�c�s�/�b�u�i�l�d�.�m�d�)� �-� �[�M�o�d�u�l�e� �c�o�n�n�e�c�t�i�o�n� �g�u�i�d�e� �(�P�N�5�3�2�,� �S�D�,� �I�R�)�]�(�.�/�d�o�c�s�/�m�o�d�u�l�e�s�.�m�d�)� �-� �[�U�s�e�r� �g�u�i�d�e�]�(�.�/�d�o�c�s�/�u�s�e�r��g�u�i�d�e�.�m�d�)� �-� �[�D�e�v�e�l�o�p�e�r� �g�u�i�d�e� �(�f�a�r� �f�r�o�m� �c�o�m�p�l�e�t�e�)�]�(�.�/�d�o�c�s�/�d�e�v�e�l�o�p�.�m�d�)� �-� �[�H�o�w� �t�o� �a�d�d� �a� �n�e�w� �f�e�a�t�u�r�e�]�(�.�/�d�o�c�s�/�a�d�d��f�e�a�t�u�r�e�.�m�d�)� �-� �[�A�d�d�i�n�g� �a�n�d� �e�d�i�t�i�n�g� �l�o�c�a�l�i�z�a�t�i�o�n�]�(�.�/�d�o�c�s�/�a�d�d��a�n�d��e�d�i�t��l�o�c�a�l�i�z�a�t�i�o�n�.�m�d�)� �-� �[�D�e�s�c�r�i�p�t�i�o�n� �o�f� �u�t�i�l�i�t�i�e�s�]�(�.�/�d�o�c�s�/�u�t�i�l�s�.�m�d�)� � �#�#� �S�i�m�p�l�e�,� �s�t�a�b�l�e�,� �c�u�s�t�o�m�i�z�a�b�l�e�,� �a�n�d� �e�x�t�e�n�s�i�b�l�e� � �T�h�i�s� �f�i�r�m�w�a�r�e�'�s� �s�t�r�u�c�t�u�r�e� �f�o�l�l�o�w�s� �t�h�e� �K�I�S�S� �p�r�i�n�c�i�p�l�e�.� �T�h�e� �c�o�d�e� �i�s� �e�x�t�r�e�m�e�l�y� �s�i�m�p�l�e� �a�n�d� �s�t�r�u�c�t�u�r�e�d�.� �A�l�l� �f�u�n�c�t�i�o�n�s� �u�s�e� �m�y� �w�r�a�p�p�e�r�s�,� �a�l�l�o�w�i�n�g� �y�o�u� �t�o� �q�u�i�c�k�l�y� �a�d�d� �n�e�w� �"�p�r�o�g�r�a�m�s�"� �w�h�i�l�e� �f�o�c�u�s�i�n�g� �o�n� �t�h�e� �f�u�n�c�t�i�o�n�a�l�i�t�y� �i�t�s�e�l�f�,� �w�i�t�h�o�u�t� �w�a�s�t�i�n�g� �t�i�m�e� �i�n�t�e�r�a�c�t�i�n�g� �w�i�t�h� �t�h�e� �i�n�t�e�r�f�a�c�e�.� � �<�i�m�g� �s�r�c�=�"�.�/�i�m�a�g�e�s�/�a�r�c�h�i�t�e�c�t�u�r�e�.�p�n�g�"� �w�i�d�t�h�=�"�5�0�0�"� �a�l�t�=�"�F�i�r�m�w�a�r�e� �a�r�c�h�i�t�e�c�t�u�r�e�"�/�>� � �Y�o�u� �c�a�n� �e�a�s�i�l�y� �a�d�d� �a� �n�e�w� �f�u�n�c�t�i�o�n� �u�s�i�n�g� �t�h�e� �[�d�o�c�u�m�e�n�t�a�t�i�o�n�]�(�#�d�o�c�u�m�e�n�t�a�t�i�o�n�)� �a�n�d� �b�y� �l�o�o�k�i�n�g� �o�n� �a�l�r�e�a�d�y� �c�r�e�a�t�e�d� �f�u�n�c�s� �i�n� ��f�u�n�c�t�i�o�n�s�/�� �f�o�l�d�e�r�.� � �#�#� �P+ �S�u�p�p�o�r�t� � �I�f� �y�o�u� �l�i�k�e�d� �t�h�i�s� �p�r�o�j�e�c�t� � ���p�l�e�a�s�e� �g�i�v�e� �i�t� �a� �s�t�a�r�.��� �I�t� �t�a�k�e�s� �2� �s�e�c�o�n�d�s� �a�n�d� �h�e�l�p�s� �t�h�e� �p�r�o�j�e�c�t� �g�r�o�w�,� �r�e�a�c�h� �m�o�r�e� �p�e�o�p�l�e�,� �a�n�d� �s�t�a�y� �m�o�t�i�v�a�t�e�d�.� � �H�a�v�e� �a� �b�u�g�,� �i�d�e�a�,� �o�r� �q�u�e�s�t�i�o�n�?� �O�p�e�n� �a�n� �[�I�s�s�u�e�]�(�h�t�t�p�s�:�/�/�g�i�t�h�u�b�.�c�o�m�/�D�l�a�z�d�e�r�/�m�5�s�t�i�c�k��c�r�y�s�t�a�l��f�i�r�m�w�a�r�e�/�i�s�s�u�e�s�)�.� �W�a�n�t� �t�o� �c�o�n�t�r�i�b�u�t�e� �c�o�d�e�?� �S�e�e� �[�C�O�N�T�R�I�B�U�T�I�N�G�.�m�d�]�(�.�/�C�O�N�T�R�I�B�U�T�I�N�G�.�m�d�)�.� � �#�#� �=؀� �U�p�c�o�m�i�n�g� �F�e�a�t�u�r�e�s� �(�2�n�d� �i�t�e�r�a�t�i�o�n�)� � �-� �[�x�]� �B�A�D� �U�S�B� �f�e�a�t�u�r�e� �-� �[�x�]� �U�S�B� �a�n�d� �B�L�E� �m�o�u�s�e� �j�i�g�g�l�e�r� �-� �[�x�]� �U�S�B� �m�o�u�s�e� �a�n�d� �k�e�y�b�o�a�r�d� �-� �[�x�]� �E�v�i�l� �p�o�r�t�a�l� �/� �E�v�i�l� �t�w�i�n� �-� �[�x�]� �H�a�n�d�s�h�a�k�e� �c�a�p�t�u�r�e� �-� �[�x�]� �P�M�K�I�D� �c�a�p�t�u�r�e� �-� �[�x�]� �w�e�b� �s�e�r�v�e�r� �i�n� �c�u�s�t�o�m� �d�i�r�e�c�t�o�r�y� �-� �[�x�]� �i�c�o�n�s� �i�n� �m�e�n�u� �-� �[� �]� �n�o�t�i�f�i�c�a�t�i�o�n�s� �i�n� �U�I� �-� �[� �]� �R�F�I�D� �f�e�a�t�u�r�e�s� �-� �[�x�]� �d�i�r�e�c�t�o�r�y� �s�u�p�p�o�r�t� �f�o�r� �f�i�l�e� �b�r�o�w�s�e�r� �-� �[�x�]� �W�i�F�i� �c�h�a�n�n�e�l� �a�n�a�l�y�z�e�r� �-� �[� �]� �p�i�x�i�e� �d�u�s�t� �a�t�t�a�c�k� �-� �[� �]� �W�P�S� �b�r�u�t�e�f�o�r�c�e� �-� �[� �]� �a�d�v�a�n�c�e�d� �w�i�f�i� �i�n�f�o� �f�e�a�t�u�r�e� �-� �[� �]� �C�S�I� �r�a�d�a�r� �-� �[�x�]� �M�5� �S�t�i�c�k� �S�3� �s�u�p�p�o�r�t� �-� �[�x�]� �M�5� �S�t�i�c�k� �S�3� �b�u�i�l�t� �i�n� �I�R� �s�u�p�p�o�r�t� �-� �[� �]� �C�H�9�3�2�9� �m�o�d�u�l�e� �s�u�p�p�o�r�t� �-� �[� �]� �N�R�F�2�4�L�0�1� �m�o�d�u�l�e� �s�u�p�o�r�t� �-� �[� �]� �C�C�1�1�0�1� �m�o�d�u�l�e� �s�u�p�p�o�r�t� �-� �[�x�]� �U�A�R�T� �t�e�r�m�i�n�a�l� �-� �[�x�]� �e�x�t�e�n�d�e�d� �s�u�p�p�o�r�t� �f�o�r� �s�e�r�i�a�l� �c�o�m�m�a�n�d�s� �-� �[� �]� �c�o�p�y�i�n�g� �a�n�d� �m�o�v�i�n�g� �f�i�l�e�s� �b�e�t�w�e�e�n� �L�F�S� �a�n�d� �S�D� �-� �[� �]� �c�r�e�a�t�i�n�g� �a�n�d� �d�e�l�e�t�i�n�g� �d�i�r�e�c�t�o�r�i�e�s� �-� �[� �]� �N�F�C� �e�m�u�l�a�t�o�r� �-� �[� �]� �t�e�s�t� �m�i�g�r�a�t�i�o�n� �t�o� �A�r�d�u�i�n�o� �3�.�X� � �<�!�-�-� �#�#�#� �W�e�b� �i�n�t�e�r�f�a�c�e� �s�c�r�e�e�n�s�h�o�t� � �<�i�m�g� �s�r�c�=�"�.�/�i�m�a�g�e�s�/�w�e�b�-�i�n�t�e�r�f�a�c�e�.�p�n�g�"� �w�i�d�t�h�=�"�3�5�0�"� �a�l�t�=�"�w�e�b� �i�n�t�e�r�f�a�c�e�"�/�>� � ��(�T�h�e� �f�e�a�t�u�r�e� �i�s� �n�o�t� �f�u�l�l�y� �i�m�p�l�e�m�e�n�t�e�d�)�� �-�-�>� �

Read the full README on GitHub

source github.com/Dlazder/m5_crystal_firmware