Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

32 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

R.A.D. Buddy (Robot Assistant Desktop)

R.A.D. Buddy is a standalone, interactive desktop companion built with Electron. He lives on your screen, reacts to your music, watches movies with you, and keeps you company while you work.

Features

  • Sharp Scaling: Uses a dynamic HTML5 Canvas renderer that scales perfectly to any size without blurriness.
  • Audio Visualization:
    • Stereo Metering: Visualizes Left/Right audio channels independently.
    • Frequency Analysis: Detects Bass, Mids, and Treble to determine if you are listening to music or watching a video.
    • Physics-based Animation: Head bobs smoothly to the beat of the music.
  • Smart Behaviors:
    • Idle: Falls asleep (ZZZ particles) if left alone.
    • Listening: Puts on headphones and headbangs when heavy bass is detected.
    • Watching: Eats popcorn when speech/video audio is detected.
    • Working: Puts on glasses (Manual Mode).
  • Interactions:
    • Drag: Click and drag anywhere on the buddy to move him.
    • Poke: Click his face to annoy him.
    • Context Menu: Right-click to Feed, change Modes, or toggle Debug info.

Installation

  1. Clone the repository.
  2. Navigate to the project folder:
    cd rad-buddy
  3. Install dependencies:
    npm install
    Note: If you are on Windows, this will also attempt to build the Windows Media Monitor native module.

Running Development Mode

To start the buddy in development mode:

npm start

Building for Distribution

To create a standalone installer (Windows .exe):

  1. Ensure you have installed the builder tools:
    npm install --save-dev electron-builder
  2. Run the build script:
    npm run dist

The output installer will be in the dist/ folder.

Controls & Debugging

Right-Click Menu

  • Feed: Triggers the eating animation.
  • Mode: Manually force specific states (Idle, Work, Music, Watch) or return to Auto.
  • Show Debug Info: Toggles a dashboard at the bottom of the window.

Debug Dashboard

  • Displays real-time audio levels (L/R Channels).
  • Displays frequency breakdown (Bass/Mid/Treble).
  • Shows current "Heuristic Ratio" used to decide between Music vs. Video modes.
  • Shows track info (if Windows SMTC is available).

Troubleshooting

"WindowsSmtcMonitor is not a constructor"

This occurs if the native C++ module for Windows Media controls wasn't built against your specific Electron version.

The app includes a fail-safe: it will launch anyway, just without song title support.

To fix:

npx electron-rebuild

"The buddy is jumping around!"

The audio visualizer is sensitive. If he is headbanging to silence:

  • Check the Debug Info to see if your microphone is being picked up as "Desktop Audio" (rare driver issue).
  • Right-click → Mode → Idle to force a reset.

License

This project is licensed under the PolyForm Noncommercial License 1.0.0. See the LICENSE file for details. This means you are free to use, modify, and share this code for personal or academic purposes, but commercial use is strictly prohibited.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages