Skip to content

numbpill3d/remu.ii

Repository files navigation

remu.ii – Handheld OS Feature Specification Document

Codename: remu.ii A stylus-based ESP32 handheld system for autonomous hacking, anomaly interaction, and cyberpet companionship.


🧠 Core System Overview

  • Device Name: remu.ii
  • Platform: ESP32 (WROOM preferred)
  • Screen: Adafruit ILI9341 with resistive touch
  • Storage: SD card (up to 512GB FAT32) via TFT slot
  • Input: Stylus (resistive touch only, no joystick or encoder)
  • Power: FuelRod lithium battery (USB-C), physical on/off switch
  • Boot: From SD card, dynamic app loader with launcher
  • UI Theme: Glitched, terminal-esque, stylus-driven OS with a touch menu to access modular apps

πŸ—‚οΈ Modular App Architecture

Each app is stored in its own folder on the SD card under /apps/. All apps are loaded dynamically to conserve memory. File structure includes a manifest, assets, and core code.

remu.ii/
β”œβ”€β”€ remu.ii.ino
β”œβ”€β”€ core/
β”‚   β”œβ”€β”€ SystemCore/
β”‚   β”‚   β”œβ”€β”€ SystemCore.cpp
β”‚   β”‚   └── SystemCore.h
β”‚   β”œβ”€β”€ DisplayManager/
β”‚   β”‚   β”œβ”€β”€ DisplayManager.cpp
β”‚   β”‚   └── DisplayManager.h
β”‚   β”œβ”€β”€ TouchInterface/
β”‚   β”‚   β”œβ”€β”€ TouchInterface.cpp
β”‚   β”‚   └── TouchInterface.h
β”‚   β”œβ”€β”€ Config/
β”‚   β”‚   └── Config.h
β”‚   β”œβ”€β”€ Settings/
β”‚   β”‚   β”œβ”€β”€ Settings.cpp
β”‚   β”‚   └── Settings.h
β”‚   β”œβ”€β”€ AppManager/
β”‚   β”‚   β”œβ”€β”€ AppManager.cpp
β”‚   β”‚   └── AppManager.h
β”œβ”€β”€ apps/
β”‚   β”œβ”€β”€ DigitalPet/
β”‚   β”‚   β”œβ”€β”€ DigitalPet.cpp
β”‚   β”‚   └── DigitalPet.h
β”‚   β”œβ”€β”€ Sequencer/
β”‚   β”‚   β”œβ”€β”€ Sequencer.cpp
β”‚   β”‚   └── Sequencer.h
β”‚   β”œβ”€β”€ WiFiTools/
β”‚   β”‚   β”œβ”€β”€ WiFiTools.cpp
β”‚   β”‚   └── WiFiTools.h
β”‚   β”œβ”€β”€ BLEScanner/
β”‚   β”‚   β”œβ”€β”€ BLEScanner.cpp
β”‚   β”‚   └── BLEScanner.h
β”‚   β”œβ”€β”€ CarCloner/
β”‚   β”‚   β”œβ”€β”€ CarCloner.cpp
β”‚   β”‚   └── CarCloner.h
β”‚   β”œβ”€β”€ FreqScanner/
β”‚   β”‚   β”œβ”€β”€ FreqScanner.cpp
β”‚   β”‚   └── FreqScanner.h
β”‚   β”œβ”€β”€ EntropyBeacon/
β”‚   β”‚   β”œβ”€β”€ EntropyBeacon.cpp
β”‚   β”‚   └── EntropyBeacon.h


🐾 Digital Pet (Entity Engine)

An AI-driven companion that lives in its own app container. Stylus-only interaction.

Features:

  • Stats: Mood, Hunger, Loneliness, Entropy, Sleep, Stability

  • Interaction: Stylus taps to pet, feed, show

  • Entropy Influence: Mood/appearance and UI fluctuates with ambient entropy

  • Learning AI: Simple memory and behavior modeling based on user input history

  • Customization:

    • Dress-up features (hats, accessories, skins, eyes, antennae)
    • Room decoration and furniture from unlockables
  • Persistence: JSON state saving to /apps/digital_pet/pet_data.json


πŸŽ›οΈ Model:Samples-Inspired Music Sequencer

A beat-making engine with glitch and ambient bias.

Features:

  • Interface: 6-track x 16-step grid (touch-select) effect knobs/toggles (popup or input based)
  • Sample System: Load .wav files from /sounds/
  • Playback Engine: Real-time, stylus-modulated tempo control
  • Preset Save/Load: /projects/*.json
  • Visuals: Pixel-glitch animations and BPM pulsing

πŸ› οΈ Hacking Utilities

1. WiFi Tools

  • SSID scanner with RSSI, channel, and MAC
  • SSID spammer (fake APs from list)
  • Deauthentication (if supported by firmware)

2. BLE Scanner

  • Nearby device discovery
  • Displays name, MAC, and signal strength
  • Logging to /logs/ble/

3. Car Cloner / Signal Replayer

  • Passive RF signal sniffer (if external hardware connected)
  • Record + replay function
  • Logs saved to /captures/car_keys/

4. Frequency Scanner

  • Signal waterfall or bar graph visualizer
  • Logs anomalous spikes with timestamp

πŸ§ͺ Entropy Beacon / NHI Anomaly Tool

Stylus-driven metaphysical contact UI for speculative signal interaction.

Features:

  • Reads entropy from floating analog pins
  • Logs spikes and patterns
  • DAC output pulses based on entropy curves
  • Graphical representation of detected anomalies
  • Stylus taps can modulate waveform (as user signal output)

πŸ”§ System Utilities

1. File Browser

  • Navigate SD file structure
  • View text logs, browse folders
  • Delete and copy functions

2. Settings Manager

  • Adjust screen brightness, auto-sleep, volume
  • Load/save settings from /sys/config.json

3. Device Resuscitator

  • Uses USBtinyISP
  • Flash Pro Micro, Trinkey, etc.
  • Includes diagrams + known bootloader images

πŸ“ File Structure Overview

remu.ii/
β”œβ”€β”€ remu.ii.ino
β”œβ”€β”€ core/
β”‚   β”œβ”€β”€ SystemCore/
β”‚   β”‚   β”œβ”€β”€ SystemCore.cpp
β”‚   β”‚   └── SystemCore.h
β”‚   β”œβ”€β”€ DisplayManager/
β”‚   β”‚   β”œβ”€β”€ DisplayManager.cpp
β”‚   β”‚   └── DisplayManager.h
β”‚   β”œβ”€β”€ TouchInterface/
β”‚   β”‚   β”œβ”€β”€ TouchInterface.cpp
β”‚   β”‚   └── TouchInterface.h
β”‚   β”œβ”€β”€ Config/
β”‚   β”‚   └── Config.h
β”‚   β”œβ”€β”€ Settings/
β”‚   β”‚   β”œβ”€β”€ Settings.cpp
β”‚   β”‚   └── Settings.h
β”‚   β”œβ”€β”€ AppManager/
β”‚   β”‚   β”œβ”€β”€ AppManager.cpp
β”‚   β”‚   └── AppManager.h
β”œβ”€β”€ apps/
β”‚   β”œβ”€β”€ DigitalPet/
β”‚   β”‚   β”œβ”€β”€ DigitalPet.cpp
β”‚   β”‚   └── DigitalPet.h
β”‚   β”œβ”€β”€ Sequencer/
β”‚   β”‚   β”œβ”€β”€ Sequencer.cpp
β”‚   β”‚   └── Sequencer.h
β”‚   β”œβ”€β”€ WiFiTools/
β”‚   β”‚   β”œβ”€β”€ WiFiTools.cpp
β”‚   β”‚   └── WiFiTools.h
β”‚   β”œβ”€β”€ BLEScanner/
β”‚   β”‚   β”œβ”€β”€ BLEScanner.cpp
β”‚   β”‚   └── BLEScanner.h
β”‚   β”œβ”€β”€ CarCloner/
β”‚   β”‚   β”œβ”€β”€ CarCloner.cpp
β”‚   β”‚   └── CarCloner.h
β”‚   β”œβ”€β”€ FreqScanner/
β”‚   β”‚   β”œβ”€β”€ FreqScanner.cpp
β”‚   β”‚   └── FreqScanner.h
β”‚   β”œβ”€β”€ EntropyBeacon/
β”‚   β”‚   β”œβ”€β”€ EntropyBeacon.cpp
β”‚   β”‚   └── EntropyBeacon.h