├── README.md └── images ├── 1.jpg ├── 2.jpg ├── 3.jpg ├── 4.jpg ├── M50-3930642_SPL.webp ├── PXL_20240721_174404806.MV.jpg ├── PXL_20240721_174449402.jpg ├── catfiles.png ├── cathack.png ├── ct09300-02-thumbnail-1080x1080-70.jpg ├── files.png ├── original.jpg ├── pinout.jpg ├── res.jpg └── the-mini-sd-card-module-micro-sd-card-module.jpg /README.md: -------------------------------------------------------------------------------- 1 | # CatHack Firmware for M5StickCPlus2 2 | ![CatHack Logo](images/cathack.png) 3 | 4 | [![Buy Me a Coffee](https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20coffee&emoji=☕&slug=Stachu&button_colour=ff8800&font_colour=000000&font_family=Lato&outline_colour=000000&coffee_colour=FFDD00)](https://buymeacoffee.com/Stachu) 5 | 6 | ## 🎉 Version 1.4 is Out! 7 | 8 | I am thrilled to announce the release of **CatHack v1.4**! This update brings exciting new features and improvements to enhance your experience. Here's what's new in this version: 9 | 10 | - **Universal Remote**: Control any TV in the world with this comprehensive remote control feature ⚠️hold the button on the right to exit to the menu⚠️ 11 | - **New Others Menu** with: 12 | - **Catgotchi**: Your virtual pet that levels up as you use CatHack features 13 | - **Lucky 7**: A casino-style game to pass the time 14 | - **Enhanced Settings**: 15 | - **ScreenSaver**: Choose between an image or black screen 16 | - **Reset Catgotchi**: Reset your virtual pet (Warning: A new name will be randomly assigned) 17 | - **IR Pin**: Select the IR LED pin 18 | - Various bug fixes and improvements 19 | 20 | Plus all the great features from previous versions: 21 | - **Deauther**: A powerful WiFi deauthentication tool for network testing 22 | - **WiFi Spam**: Capability to flood the area with fake WiFi networks 23 | - **Brightness Control**: Adjust the screen brightness for optimal visibility 24 | - **RF Analyzer**: A powerful tool to identify and analyze the frequency of your SubGhz devices 25 | - **BLE Spam**: Spam advertising packets over Bluetooth Low Energy 26 | - **Bad Portal**: Create fake login pages for security testing 27 | - **Web Interface**: Easily add or remove files through a network interface 28 | 29 | CatHack continues to evolve, and I'm committed to providing you with the best tools for your M5StickCPlus2. 30 | 31 | ## 📸 Device Setup 32 |
33 | CatHack Device Setup 34 | CatHack Result 35 |
36 | 37 | Check out the [3D model of my setup](https://www.tinkercad.com/things/jU8COj6wvHs-copy-of-m5cat-plus-2-lego) for a detailed view! 38 | 39 | Model made by [STP | MFTEN](https://www.tinkercad.com/things/6C5WqbT3iW9-m5cat-plus-2-lego?sharecode=Xh-GteGc18yoXvBrgn3utlEWV8_2JhlV2xhRgVijvh4) 40 | 41 | ## ❗Please read the installation instructions carefully❗ 42 | 43 | ## 🚀 Features 44 | 45 | ### 📺 Infrared Menu 46 | - **TVBGone**: Turn off all nearby televisions with a single click 47 | - **Universal Remote**: Control any TV worldwide with comprehensive remote control features 48 | 49 | 50 | ### 📡 SubGhz Menu 51 | - **SubSend**: Transmit .sub files from Flipper Zero using the CC1101 module (currently supports RAW protocol). 52 | - **SubRecord**: Capture signals from devices using the CC1101 module and save them to an SD card. 53 | - **Jammer**: Disrupt selected frequencies. 54 | - **Monitor**: Visualize received signals in real-time. 55 | - **RF Analyzer**: Identify and analyze the frequency of your SubGhz devices. 56 | 57 | ### 🌐 WiFi Menu 58 | - **Wardriving**: Collect and log information about nearby networks. 59 | - **Bad Portal**: Create fake login pages for security testing. 60 | - **Web Interface**: Network interface for adding/removing files. 61 | - **Deauther**: Perform WiFi deauthentication attacks for network testing. 62 | - **WiFi Spam**: Generate multiple fake WiFi networks to flood the area. 63 | 64 | ### 🦷 Bluetooth Menu 65 | - **Skim Check**: Detect potential credit card skimmers in your vicinity. 66 | - **BLE Spam**: Spam advertising packets over Bluetooth Low Energy. 67 | 68 | ### 🎮 Others Menu 69 | - **Catgotchi**: Virtual pet that gains levels as you use CatHack features 70 | - **Lucky 7**: Casino-style game for entertainment 71 | 72 | ### ⚙️ Settings Menu 73 | - **Set Frequency**: Configure the frequency for SubRecord, Monitor, Jammer, and RF Analyzer functionalities 74 | - **Set Brightness**: Adjust the screen brightness for optimal visibility 75 | - **ScreenSaver**: Choose between an image or black screen 76 | - **Reset Catgotchi**: Reset your virtual pet (Warning: Generates a new random name) 77 | - **IR Pin**: Configure the IR LED pin 78 | 79 | ## 🐬 Flipper Zero Compatibility 80 | CatHack supports .sub files with RAW protocol from Flipper Zero. All necessary files, including compatible Flipper Zero files, are included in the [CatFiles.zip](https://drive.google.com/file/d/1RKXt6-wOJWU3LxkXymQJNm4udPsosoiT/view?usp=sharing) package. Simply download and extract these files to your SD card to use them with CatHack. 81 | 82 | 83 | 84 | ## 🔮 Planned Future Features 85 | - **IR Send**: Send recorded IR codes or codes from Flipper Zero. 86 | - **IR Record**: Record IR codes. 87 | - **NFC/RFID Read**: Read NFC/RFID tags and save data to SD card. 88 | - **NFC/RFID Emulate**: Emulate NFC/RFID tags using saved data. 89 | 90 | ## 🛠️ Required Components 91 | - Curved pin headers 92 | ![Curved Pin Headers](images/M50-3930642_SPL.webp) 93 | - CC1101 module 94 | CC1101 Module 95 | - Compact micro SD card module 96 | SD Card Module 97 | - Double-Sided Prototype Board (3x7cm recommended) 98 | Prototype Board 99 | - Soldering iron and proficiency in soldering 100 | 101 | While it's possible to connect components using cables, soldering is recommended for a more reliable and compact setup. 102 | 103 | ## 📊 Pinout Diagram 104 | ![Pinout Diagram](images/pinout.jpg) 105 | 106 | | M5StickCPlus2 | CC1101 | SD Card Module | 107 | |:------------------:|:------:|:--------------:| 108 | | GND | GND | GND and CS | 109 | | G26 | CSN | MOSI | 110 | | G36/G25 | GDO0 | MISO | 111 | | G0 | SCK | CLK | 112 | | 3v3 | Vcc | 3v3 | 113 | | G32 (bottom pin) | MOSI | - | 114 | | G33 (bottom pin) | MISO | - | 115 | 116 | ⚠️ Remember to connect CS to GND on the SD card module, otherwise it will not work. ⚠️ 117 | 118 | ## 📥 Installation Guide 119 | 1. Download and flash the firmware using M5Burner. 120 | 2. Download the [CatFiles.zip](https://drive.google.com/file/d/1RKXt6-wOJWU3LxkXymQJNm4udPsosoiT/view?usp=sharing) and extract its contents to your SD card, it should look like this: 121 | 122 | 123 | ⚠️ Note: Some files may not be compatible as only the RAW protocol is currently supported. ⚠️ 124 | 125 | 3. Insert the SD card into the module, and you're ready to go! 126 | 127 | ## 🌐 Web Interface Login 128 | The default login credentials for the Web Portal are as follows: 129 | 130 | **Login**: `cath` 131 | **Password**: `cath` 132 | 133 | ## 📱 Media 134 | Stay updated with CatHack through various media channels: 135 | 136 | - **Reddit Posts**: Check out my latest updates and discussions on [Reddit](https://www.reddit.com/user/Stachu1134/) 137 | - **YouTube Video**: Watch the CatHack in action: [CatHack Video](https://youtu.be/UGI_UZwbe0s?si=uOVqKbpcL1EUcegq) 138 | - **Instagram Feature**: CatHack was featured by M5Stack on their [Instagram](https://www.instagram.com/p/C-9FTYPBu99/?img_index=1) 139 | 140 | ## How I Did It 141 | 142 | 143 | 144 | 145 | 146 | ## 📞 Support 147 | If you have any questions or suggestions, feel free to reach out: 148 | - Discord: stachu0 149 | 150 | 151 | ## ❓ Troubleshooting 152 | 153 | Why isn't signal recording working? 154 | 155 | 1. **Incorrect connections**: Double-check your wiring and connections between the components. 156 | 2. **Using M5 Launcher**: Ensure that you're running the CatHack firmware directly, not by using m5launcher. 157 | 3. **Missing files on the SD card**: Ensure you've added all required files to the SD card. Refer to the installation guide for details on what should be included. 158 | 159 | why doesn't tvbgone/universal remote work? 160 | 1. **Incorrect IR pin**: go to settings->ir pin and set it to default 161 | 162 | ## ⚠️ Disclaimer 163 | This software is intended for educational and research purposes only. The author bears no responsibility for any misuse of this software. Use it responsibly and in compliance with all applicable laws and regulations. 164 | 165 | --- 166 | 🐱 Happy Hacking with CatHack! 🐱 167 | -------------------------------------------------------------------------------- /images/1.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Stachugit/CatHack/3b08d09e14833978c1871bd0287394213a3d30ec/images/1.jpg -------------------------------------------------------------------------------- /images/2.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Stachugit/CatHack/3b08d09e14833978c1871bd0287394213a3d30ec/images/2.jpg -------------------------------------------------------------------------------- /images/3.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Stachugit/CatHack/3b08d09e14833978c1871bd0287394213a3d30ec/images/3.jpg -------------------------------------------------------------------------------- /images/4.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Stachugit/CatHack/3b08d09e14833978c1871bd0287394213a3d30ec/images/4.jpg -------------------------------------------------------------------------------- /images/M50-3930642_SPL.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Stachugit/CatHack/3b08d09e14833978c1871bd0287394213a3d30ec/images/M50-3930642_SPL.webp -------------------------------------------------------------------------------- /images/PXL_20240721_174404806.MV.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Stachugit/CatHack/3b08d09e14833978c1871bd0287394213a3d30ec/images/PXL_20240721_174404806.MV.jpg -------------------------------------------------------------------------------- /images/PXL_20240721_174449402.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Stachugit/CatHack/3b08d09e14833978c1871bd0287394213a3d30ec/images/PXL_20240721_174449402.jpg -------------------------------------------------------------------------------- /images/catfiles.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Stachugit/CatHack/3b08d09e14833978c1871bd0287394213a3d30ec/images/catfiles.png -------------------------------------------------------------------------------- /images/cathack.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Stachugit/CatHack/3b08d09e14833978c1871bd0287394213a3d30ec/images/cathack.png -------------------------------------------------------------------------------- /images/ct09300-02-thumbnail-1080x1080-70.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Stachugit/CatHack/3b08d09e14833978c1871bd0287394213a3d30ec/images/ct09300-02-thumbnail-1080x1080-70.jpg -------------------------------------------------------------------------------- /images/files.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Stachugit/CatHack/3b08d09e14833978c1871bd0287394213a3d30ec/images/files.png -------------------------------------------------------------------------------- /images/original.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Stachugit/CatHack/3b08d09e14833978c1871bd0287394213a3d30ec/images/original.jpg -------------------------------------------------------------------------------- /images/pinout.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Stachugit/CatHack/3b08d09e14833978c1871bd0287394213a3d30ec/images/pinout.jpg -------------------------------------------------------------------------------- /images/res.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Stachugit/CatHack/3b08d09e14833978c1871bd0287394213a3d30ec/images/res.jpg -------------------------------------------------------------------------------- /images/the-mini-sd-card-module-micro-sd-card-module.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Stachugit/CatHack/3b08d09e14833978c1871bd0287394213a3d30ec/images/the-mini-sd-card-module-micro-sd-card-module.jpg --------------------------------------------------------------------------------