Troubleshooting OnStagePlayer: Common Issues and Fast FixesOnStagePlayer is a powerful tool for performers and live-production teams, but like any software used in high-pressure live environments it can run into problems. This article walks through the most common issues users face with OnStagePlayer, explains likely causes, and gives clear, actionable fixes—fast—so you can get back to the show. Where helpful, I include preventive steps and quick checks to run before you go on stage.
1) Player won’t launch or crashes immediately
Common symptoms: application refuses to open, opens then closes, or crashes on startup.
Likely causes
- Corrupted installation files or update gone wrong.
- Conflicting software (audio drivers, other audio apps, or security software).
- Insufficient system resources or incompatible OS version.
- Corrupt user preferences or cache.
Fast fixes
- Restart your computer. A simple reboot can clear locked resources or driver conflicts.
- Run as Administrator (Windows) / with elevated privileges (macOS).
- Reinstall OnStagePlayer. Uninstall, restart, then download the latest installer from the official source and reinstall.
- Reset preferences/cache. Locate the app’s preferences folder (OS-dependent) and move it temporarily to another location, then relaunch to create a fresh profile.
- Check compatibility & updates. Ensure your OS version meets minimum requirements and install any pending OS updates, plus the latest OnStagePlayer release.
- Temporarily disable antivirus/security software and test launch (re-enable after testing).
Preventive tips
- Keep backups of custom presets and show files.
- Test updates on a secondary machine before using them in live shows.
2) Audio output problems (no sound, stuttering, latency)
Common symptoms: no audio, dropouts, pops/clicks, high latency between trigger and sound.
Likely causes
- Incorrect audio device selection in app.
- Sample-rate mismatches between system, audio interface, and OnStagePlayer.
- Buffer size set too low or driver issues (ASIO vs. WASAPI/CoreAudio).
- CPU overload or heavy plugins consuming resources.
- Faulty cables or hardware routing errors.
Fast fixes
- Check audio device selection. In OnStagePlayer’s audio preferences, ensure the correct physical output/interface is chosen.
- Match sample rates. Set the same sample rate in system audio settings, your audio interface control panel, and OnStagePlayer (common values: 44.1 kHz or 48 kHz).
- Increase buffer size. Raise the audio buffer (e.g., from 64 to 256 samples) to reduce dropouts; lower it only if needed for tight latency during rehearsal.
- Switch to the recommended driver. Use ASIO on Windows for best performance; on macOS use CoreAudio. Consider installing ASIO4ALL only if you lack a dedicated driver.
- Close other audio-heavy apps and background processes to free CPU.
- Test with a different cable/output to rule out hardware issues.
Preventive tips
- Use a dedicated audio interface with stable, class-compliant drivers.
- Create a show template with confirmed sample rate/buffer settings.
3) MIDI or trigger devices not responding
Common symptoms: MIDI controllers, footswitches, or external trigger devices aren’t controlling playback or responding intermittently.
Likely causes
- Incorrect MIDI port/device selected.
- MIDI channel mismatch or mapping conflicts.
- USB power or bandwidth issues (especially with many devices).
- Driver/controller firmware problems.
Fast fixes
- Verify device visibility. Make sure the controller appears in system MIDI devices and in OnStagePlayer’s MIDI settings.
- Select correct MIDI port and channel. Confirm the app is listening on the same MIDI channel the controller transmits on.
- Reload MIDI mappings. Reassign or re-import saved mappings; test with a simple mapping (single button to play) to isolate complexity.
- Use a powered USB hub if devices drop due to power/bandwidth.
- Update firmware and drivers for your controller and interface.
- Test with another controller or with a virtual MIDI keyboard to isolate hardware vs. app issues.
Preventive tips
- Save backup mapping files and keep a printed quick-mapping checklist for quick recovery.
- Label MIDI channels and ports in your show file.
4) Show file or cue sequence issues (missing files, wrong cues)
Common symptoms: audio files show as missing, cues fire out of order, or silence during expected playback.
Likely causes
- Moved/renamed media files or broken path references.
- Corrupt show file or incompatible show file version.
- Incorrect cue numbering or linked cue logic errors.
- External drives disconnected or asleep.
Fast fixes
- Relink missing files. Use OnStagePlayer’s media manager or “Relink” feature to point to the correct file locations.
- Keep media in a single, dedicated folder. Avoid absolute paths that change between machines; use relative paths when supported.
- Mount external drives before launching and disable sleep/power-saving on drive controllers.
- Check cue numbering and logic. Validate that cues are in the correct sequence and that any conditional or chained cues are set correctly.
- Restore from backup. If the show file is corrupt, revert to the most recent working backup.
Preventive tips
- Always bundle shows with a “media” folder and use network/portable drives with consistent drive letters or mount points.
- Save incremental versions of show files (Show_v1, Show_v2).
5) Video playback issues (stuttering, resolution mismatch, black screen)
Common symptoms: videos skip, play without audio, are stretched or black.
Likely causes
- Unsupported codec or container.
- GPU acceleration issues or insufficient GPU power.
- Wrong aspect or resolution settings.
- Hardware decoders vs. software fallback conflicts.
Fast fixes
- Use supported codecs. Convert video to a widely compatible format (H.264 in MP4 container for most systems) with consistent frame rates.
- Match output resolution. Set video output resolution and aspect ratio to match the projector/display.
- Enable/disable hardware acceleration. Toggle GPU acceleration in OnStagePlayer to see which performs better.
- Update GPU drivers and ensure the system’s video drivers are current.
- Pre-render complex video/audio mixes. Combine layered effects into a single pre-rendered file to reduce real-time decoding load.
Preventive tips
- Test videos on the exact playback machine before show day.
- Keep a lower-resolution backup video file ready for emergency swaps.
6) Sync issues between audio and lighting or other show systems
Common symptoms: audio drifts relative to lighting cues or external playback systems, or MIDI Time Code (MTC)/SMPTE sync jumps.
Likely causes
- Incorrect frame rate or timecode settings.
- Network latency (if using network-based protocols like OSC or AVB).
- Multiple devices trying to be master clock.
Fast fixes
- Check frame rates and timecode format. Ensure all devices share the same FPS and timecode standard (e.g., 30 fps drop-frame vs. 29.97).
- Use a single timecode master. Designate one device as the master clock and configure others as slaves.
- Reduce network traffic or isolate show-control network on its own switch/VLAN to minimize latency.
- Use dedicated cables for SMPTE or word clock where possible rather than relying on USB-based timecode.
Preventive tips
- Rehearse full system sync before performances and log final working settings.
- Consider running timecode over a dedicated network for larger rigs.
7) Licensing, activation, or feature limitations
Common symptoms: key features locked, license errors, or time-limited functionality stopping mid-show.
Likely causes
- License not activated or expired.
- Machine ID changed (hardware change) causing license mismatch.
- Network activation servers unreachable.
Fast fixes
- Verify license status in the app and on your account portal.
- Reactivate license following vendor instructions; use offline activation if available.
- Contact support with invoice/order details if activation fails due to hardware changes.
- Keep a backup activation method (e.g., dongle or offline license) for mission-critical shows.
Preventive tips
- Renew licenses well before show dates.
- Carry a backup license dongle or alternate device preactivated.
8) Performance drops during long shows (memory growth, CPU spikes)
Common symptoms: app becomes slower over time, memory usage climbs, or periodic stuttering after extended runtime.
Likely causes
- Memory leak in app or third-party plugins.
- Accumulation of buffered audio/video data or logging.
- CPU throttling due to overheating.
Fast fixes
- Restart the app during planned breaks between sets if allowed.
- Disable unnecessary logging and background tasks.
- Update the app—vendors often patch memory leaks in minor releases.
- Check cooling and CPU throttling. Ensure vents are clear and power plan is set to high performance.
- Use fewer real-time effects/plugins and pre-render where possible.
Preventive tips
- Run long-duration stress tests before tours.
- Keep the machine on a cooled stage case or rack with proper airflow.
9) UI, layout, or workspace problems (missing panels, unreadable text)
Common symptoms: panels or toolbars disappear, text too small/large, or UI elements overlap on high-DPI screens.
Likely causes
- Display scaling/DPI settings, especially with multi-monitor setups.
- Hidden panels or detached windows.
- Corrupted workspace/layout config.
Fast fixes
- Reset workspace/layout from the View or Window menu to restore default panels.
- Adjust display scaling in OS settings (100%/125%) or in the app if a scaling option exists.
- Dock or undock panels intentionally to reorganize the stage view.
- Update app for improved high-DPI support.
Preventive tips
- Use consistent display scaling across monitors.
- Save a custom workspace once configured.
10) Unexpected behavior after updates
Common symptoms: formerly working features break, new bugs appear, or plugins stop working after an upgrade.
Likely causes
- Incompatibility with older show files or plugins.
- Change in defaults or hidden settings.
- Partial/failed update.
Fast fixes
- Rollback to previous version if the update causes critical failures (keep older installers archived).
- Check release notes to see changed behaviors and required migration steps.
- Reinstall plugins or update them to compatible versions.
- Contact support with logs and a reproducible test case.
Preventive tips
- Test updates on a staging machine before deploying to production.
- Keep a pre-show checklist that includes verifying critical features after updates.
Quick checklist to run before showtime
- System reboot within the last few hours.
- External drives mounted and media folder accessible.
- Correct audio device, sample rate, and buffer settings.
- MIDI devices recognized and mappings loaded.
- Video resolution and codecs verified on the playback machine.
- Timecode master configured and network isolated.
- License active and app up to date (but tested).
- Backup show file and backup media folder on a second drive.
- Contact/support info readily available.
If you want, I can:
- Provide platform-specific paths to preferences/cache to reset.
- Convert this into a printable one-page troubleshooting checklist.
- Walk through a specific error message you’re seeing — paste it here and I’ll diagnose.
Leave a Reply