A handheld multifaceted modular device for hacking, music production, and metaphysical exploration.

remu.ii is a stylus-based handheld device powered by an ESP32 microcontroller that combines:

• 🐾 AI Cyberpet Companion with mood tracking and entropy influence
• 🎵 8-Track Music Sequencer for beat-making and glitch music
• 📡 WiFi Security Tools for network scanning and security research
• 🔵 BLE Scanner with anomaly detection
• 📻 RF Tools for signal capture and analysis
• 📊 FFT Spectrum Analyzer for signal processing
• 🌀 Entropy Visualizer for metaphysical anomaly detection

All housed in a portable device with a 2.8" touchscreen, SD card storage, and retro "terminal glitch" aesthetic.

• ESP32 WROOM-32 dual-core processor (240MHz)
• 2.8" ILI9341 TFT Display (320x240 pixels, 16-bit color)
• 4-wire resistive touchscreen (stylus-based input)
• SD card support (up to 512GB, FAT32)
• LiPo battery with USB-C charging
• WiFi + Bluetooth LE connectivity
• I2S audio output
• True entropy sources from floating analog pins

• Modular architecture - Apps load dynamically
• Memory-optimized - Runs on 320KB RAM
• Persistent storage - Save state to SD card
• Touch gestures - Tap, drag, swipe, long-press
• Watchdog protection - Auto-recovery from crashes
• Battery monitoring - Real-time power management
• Retro UI - Darknet terminal aesthetic

1. Get the hardware - See ASSEMBLY_GUIDE.md for build instructions
2. Install firmware - Follow INSTALLATION_GUIDE.md for Arduino IDE setup
3. Learn to use - Read USER_MANUAL.md for detailed usage instructions

1. Clone the repository:

   git clone https://github.com/numbpill3d/remu.ii.git
   cd remu.ii

2. Install Arduino IDE and ESP32 board support

3. Install required libraries:

   • Adafruit GFX Library (≥1.11.0)
   • Adafruit ILI9341 (≥1.6.0)
   • ArduinoJson (v6.x)

4. Open remu_ii.ino in Arduino IDE

5. Select board: ESP32 Dev Module

6. Configure settings:

   • Upload Speed: 921600
   • CPU Frequency: 240MHz
   • Flash Size: 4MB

7. Upload firmware to your ESP32

See API_REFERENCE.md for development documentation.

• USER_MANUAL.md - Complete user guide with app instructions
• INSTALLATION_GUIDE.md - Firmware installation and setup
• ASSEMBLY_GUIDE.md - Hardware assembly instructions with wiring diagrams
• API_REFERENCE.md - Developer API documentation
• HARDWARE_WIRING.md - Detailed pin connections
• COMPILATION_STATUS.md - Build configuration and status

AI-driven cyberpet companion with psychological mood system, personality traits, and archetype-based behavior. Your pet's mood is influenced by ambient entropy and your interactions.

Features: CALM/RESTLESS/OBSESSED/GLITCHED moods, LOVING/AGGRESSIVE/NEEDY/PARANOID traits, ORACLE/PARASITE/MIRROR archetypes

8-track, 16-step drum machine and beat sequencer with glitch aesthetic.

Features: 16-step grid, 8 tracks, BPM control, swing adjustment, pitch shift, distortion/bitcrush/delay effects, pattern save/load

Network security testing and analysis platform.

Features: WiFi scanner, SSID discovery, security type detection, client enumeration, deauth attacks, beacon spam, evil twin AP

⚠️ For authorized security testing only

Bluetooth Low Energy device discovery with advanced anomaly detection.

Features: Device scanning, RSSI tracking, anomaly detection (MAC randomization, signal spoofing, timing irregularities), device labeling, statistics

RF signal capture, analysis, and replay for security research.

Features: Multi-frequency support (315MHz, 433.92MHz, 868MHz, 915MHz), modulation detection (ASK/FSK/PSK/OOK), protocol analysis, signal library

⚠️ For authorized security research only

Real-time FFT spectrum analyzer with waterfall display.

Features: FFT processing (128-1024 samples), window functions, peak detection, spectrum smoothing, signal recording, signal generator

Real-time entropy visualization and anomaly detection from floating analog pins.

Features: Oscilloscope/spectrum visualization, multiple sample rates, anomaly detection, DAC output, entropy-driven waveforms

• ESP32 WROOM-32 development board
• 2.8" ILI9341 TFT display with SPI interface
• 4-wire resistive touchscreen
• Micro SD card slot (usually built into display)
• LiPo battery (3.7V, 1000-2000mAh)
• TP4056 USB-C charging module
• Stylus for resistive touch

• I2S DAC or amplifier for audio
• Speaker or headphone jack
• RF modules for extended functionality
• Custom 3D-printed enclosure

See ASSEMBLY_GUIDE.md for complete parts list and wiring.

remu.ii/
├── remu_ii.ino                 # Main entry point
├── core/                       # Core system modules
│   ├── SystemCore/             # Power, entropy, watchdog
│   ├── DisplayManager/         # ILI9341 control, UI rendering
│   ├── TouchInterface/         # 4-wire touch + gestures
│   ├── AppManager/             # Dynamic app loading
│   ├── Settings/               # JSON configuration
│   ├── FileSystem/             # SD card abstraction
│   └── Config/                 # Hardware pin definitions
├── apps/                       # Application modules
│   ├── DigitalPet/             # AI cyberpet companion
│   ├── Sequencer/              # Music production
│   ├── WifiTools/              # Network security
│   ├── BLEScanner/             # Bluetooth analysis
│   ├── CarCloner/              # RF tools
│   ├── FreqScanner/            # FFT spectrum analyzer
│   └── EntropyBeacon/          # Entropy visualization
├── Documentation/              # Additional docs
│   ├── USER_MANUAL.md
│   ├── INSTALLATION_GUIDE.md
│   ├── ASSEMBLY_GUIDE.md
│   ├── API_REFERENCE.md
│   └── HARDWARE_WIRING.md
└── README.md                   # This file

remu.ii includes tools for authorized security testing and educational purposes only.

• WiFi deauth, beacon spam: May be illegal without authorization
• RF transmission: Requires proper licensing in many jurisdictions
• Network testing: Only test networks you own or have written permission
• Responsible use: Always comply with local laws and regulations

• Authorized penetration testing
• Security research in controlled environments
• Educational purposes
• CTF competitions
• Personal creative projects

Users assume all legal responsibility for their actions.

Contributions are welcome! Here's how:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open a Pull Request

• Follow existing code style
• Document public APIs
• Test on real hardware when possible
• Update documentation for user-facing changes
• Write clear commit messages

• Bug reports: Open an issue with detailed description and steps to reproduce
• Feature requests: Describe the feature and its use case
• Questions: Check documentation first, then open a discussion

This project is open source. See LICENSE file for details.

• ESP32 by Espressif Systems
• ILI9341 Display compatible with Adafruit modules
• Arduino Framework for ESP32

• Adafruit GFX Library
• Adafruit ILI9341
• ArduinoJson
• ESP32 Arduino Core

• Retro handheld consoles
• Cyberdeck culture
• Security research tools
• Glitch aesthetics

If you find remu.ii useful:

• ⭐ Star this repository
• 🐛 Report bugs and suggest features
• 🔧 Contribute code or documentation
• 🎨 Share your projects and mods
• 💬 Join the community discussions

• GitHub: @numbpill3d
• Project: github.com/numbpill3d/remu.ii
• Issues: github.com/numbpill3d/remu.ii/issues

• ✅ Core system architecture
• ✅ Display and touch management
• ✅ App launcher and lifecycle
• ✅ Digital Pet with mood system
• ✅ WiFi/BLE security tools
• ✅ Sequencer framework
• ✅ Entropy system
• ✅ Comprehensive documentation

• 🚧 Complete sequencer audio implementation
• 🚧 Expand RF tools capabilities
• 🚧 Additional Digital Pet features

• 📋 OTA firmware updates
• 📋 Web-based configuration interface
• 📋 Additional applications (IRC client, file manager, etc.)
• 📋 Custom PCB design
• 📋 Injection-molded enclosure
• 📋 Community app marketplace

A: Yes, but only on networks/devices you own or have written authorization to test. Unauthorized testing is illegal.

A: Depends on usage. WiFi scanning drains faster (~2-4 hours). Normal use with BLE/display (~4-6 hours). Low-power mode extends runtime.

A: Absolutely! See API_REFERENCE.md for developer documentation on creating custom apps.

A: No, it's designed for resistive touch (stylus-based). Capacitive screens require different hardware and drivers.

A: Potentially, but you'll need to modify the display driver code. The ILI9341 is recommended for compatibility.

A: Not currently. This is a DIY project. See ASSEMBLY_GUIDE.md for build instructions.

Built with curiosity, code, and a little chaos.

Stay weird. Hack responsibly.

Last Updated: 2025-11-12 Version: 1.0 Status: Feature Complete, Documentation Complete