Robot Audio Command Sequencer - User Guide

Overview

The Robot Audio Command Sequencer is a powerful tool for creating custom audio programs for vintage robots that use audio cassette tapes for command input. This software is compatible with Robie Sr. and OmniBot 2000 series robots, allowing you to create sophisticated movement sequences, lighting effects, and voice recordings.

Getting Started

System Requirements

Installation

  1. Ensure all required Python packages are installed:

pip install pygame numpy scipy sounddevice soundfile

  1. Place the 8 robot command WAV files (wav1.wav through wav8.wav) in the same directory as the program

  2. Run: python robot-audio-sequencer.py

Robot Commands

Basic Movement Commands

Special Commands

Custom Commands

Using the Interface

1. Command Buttons

Click any command button to add it to your timeline. Commands are automatically positioned after the previous command.

Smart Spacing:

2. Timeline

The timeline shows your complete command sequence with color-coded blocks:

Timeline Features:

3. Voice Recording Controls

Volume Boost (0.1x to 10.0x)

Real-time Level Meter

Recording Process

  1. Set desired volume boost level

  2. Click “Record Voice” to start

  3. Speak into microphone while monitoring the level meter

  4. Click “Record Voice” again to stop

  5. System automatically adds: SoundOn → Your Voice → SoundOff

Import Audio Files

  1. Set volume boost level

  2. Click “Import Audio File”

  3. Select supported audio file (WAV, MP3, FLAC, OGG, M4A, AAC)

  4. File is automatically processed and added with SoundOn/SoundOff wrapper

4. Playback Controls

5. Timeline Management

6. File Operations

Creating Robot Programs

Basic Sequence Example

  1. Click “Forward” → “Right” → “Forward” → “Light” → “Bleep”

  2. Add a voice recording: “Hello, I am your robot!”

  3. Click “Play” to test your sequence

  4. Export to MP3 when satisfied

Advanced Programming Tips

Movement Patterns

Voice Integration

Timing Considerations

Cassette Recording Process

Preparation

  1. Create and test your complete sequence in the software

  2. Export to MP3 or WAV format

  3. Ensure good audio quality with no clipping

Recording to Cassette

  1. Use a high-quality cassette recorder

  2. Set recording levels appropriately (not too loud)

  3. Record your exported audio file to cassette

  4. Test the cassette with your robot before final use

Robot Compatibility

This software generates audio commands compatible with:

Troubleshooting

Audio Issues

Performance Issues

File Issues

Tips for Best Results

  1. Start Simple: Begin with basic movement sequences before adding complex voice content

  2. Test Frequently: Use the Play button to verify sequences before exporting

  3. Monitor Levels: Keep voice recordings in the green/yellow range

  4. Save Often: Use Save Project to preserve your work

  5. Organize Commands: Use the visual timeline to plan complex sequences

  6. Cassette Quality: Use high-quality cassette tapes for reliable robot operation


Compatible Robots: Robie Sr., OmniBot 2000 series

Audio Format: Cassette tape input

Software Version: 1.0