Teleport Troubleshooting

Quick fixes for common Teleport issues. Try these steps before contacting support.

First: Sign In and Update

Many issues happen because users skip signing in or updating.

Before troubleshooting:

  1. Sign in to the app with your Apple ID (iOS) or Google account (Android). Most features and updates wonโ€™t work without signing in.
  2. Update the app when prompted.

Why this matters: Features youโ€™re looking for might only be available in newer versions. We regularly add improvements and fixes.

Finding version numbers:

  • App version: Found on the Home page of the PeekSmith app.

Teleport Wonโ€™t Power On (Stuck on โ€œPower Offโ€)

Quick Fixes:

  1. Press and hold the button on the back for 1-2 seconds until the screen changes
  2. Check battery level - Charge if needed (red LED should be on during charging)
  3. Align properly on charger - Center the marking on Teleport with the Qi charger
  4. Try a different USB cable or power source

Still stuck?

  • Wait 30 seconds after holding the button
  • Try plugging into a computer USB port instead of a wall charger

Teleport Doesnโ€™t Appear in Device List

Quick Fixes:

  1. Ensure Teleport is powered on - Screen should show content, not โ€œPower Offโ€
  2. Enable Bluetooth on your phone
  3. Close other apps that might be connected to Teleport
  4. Restart the PeekSmith app
  5. Restart your phone if on Android

Still not appearing?

  • Check that youโ€™re signed into the PeekSmith app with Apple ID/Google account
  • Make sure you have the latest app version

Tests Work, But Real Sends Fail

Quick Fixes:

  1. Check connection status in the PeekSmith app - should show as connected
  2. Verify trigger setup - Is your remote/trigger device properly configured?
  3. Confirm action selection - Did you choose the right action type?
  4. Check text buffer - Does it contain what you expect?

Common causes:

  • Wrong trigger method selected
  • Action type mismatch (text vs card vs image)
  • Trigger device not properly connected

โ€œError Downloading Image from URLโ€

Quick Fixes:

  1. Check internet connection - Ensure your phone has stable WiFi/cellular data
  2. Verify URL format - Should start with http:// or https://
  3. Test the URL in your phoneโ€™s browser to ensure itโ€™s accessible
  4. Check image format - Must be 240ร—416 pixels, using only black/white/red/yellow

Still failing?

  • Try a different image URL
  • Reduce image complexity
  • Ensure the server hosting the image allows external access

โ€œText Sentโ€ But Teleport Stays Unchanged

Quick Fixes:

  1. Wait the full 30 seconds - E-ink refresh takes ~22 seconds
  2. Check if Teleport is still connected in the app
  3. Verify trigger setup - Was the trigger properly activated?
  4. Check action configuration - Is the right action selected?

Diagnostic Steps:

  1. Try sending a simple poker card image instead
  2. Test with a different trigger method
  3. Check that the text buffer contains expected content

Background Colors / Brightness Concerns

Color Limitations:
Teleport uses a 4-color e-ink display that can show black, white, red, and yellow. While images can be created with other colors, they will be converted to the closest available color and may look like they were printed with an older printer.

Visual Appearance:
This is normal and expected therefore Teleport is designed to be used inside the neck holder. The colors look good visually because of the plastic window and lighting conditions, which is intentionally designed to mimic real paper for convincing spectator experiences.

Lighting Conditions:

  • E-ink visibility depends on ambient lighting
  • Works best in moderate lighting conditions
  • May appear washed out in direct sunlight
  • The neck holderโ€™s lighting is intentionally designed to be subtle

Stage Reliability (Distance / Speakers / Interference Tips)

Bluetooth Range:

  • Maximum distance: 10 meters (33 feet) in ideal conditions
  • Obstacles: Keep clear line of sight between phone and Teleport
  • Interference: Move away from other Bluetooth devices

Performance Environment:

  • Speaker systems: Powerful speakers can interfere with Bluetooth
  • Crowded venues: Many phones/bluetooth devices can cause congestion
  • Metal objects: Keep Teleport away from large metal surfaces

Stage Best Practices:

  1. Position yourself within 5 meters of Teleport during performance
  2. Turn off unused Bluetooth devices nearby
  3. Keep phone in your pocket or on stage, not in audience area
  4. Test in your performance environment beforehand

Still Need Help?

Weโ€™re here to help. Before reaching out, please gather:

  • Device type: Teleport
  • App version: Found in PeekSmith app settings
  • Phone type: iOS or Android, and version
  • Order ID: If you purchased from us
  • Description: Whatโ€™s happening vs. what you expected
  • Video: A short recording helps us understand the issue faster

Contact us: For app questions, device issues, orders, or warranty support, contact us.

Community support: Join the Teleport Facebook Group for peer support and tips.