Troubleshooting Guide

Having issues with Revolt? Find solutions to common problems below.

Script Issues

Script Not Loading

Symptoms:

• The Tampermonkey icon shows no running script on the course page
• No Revolt sidebar, and Ctrl + Shift + R does nothing

Solutions:

1. Check that userscripts are allowed

   • On Chrome and Edge, go to chrome://extensions or edge://extensions and make sure Developer mode is on
   • Click the Tampermonkey icon and choose Enable userscripts if it asks

2. Check that the script is enabled

   • Open the Tampermonkey Dashboard and make sure REVOLT is switched on
   • If you have more than one Revolt script (for example an old copy), keep only one

3. Remove the old RevoltX extension

   • The extension is no longer supported. Go to chrome://extensions, remove RevoltX, and reload the course tab so it doesn't fight the script

4. Reinstall the script

   • Delete it from the Tampermonkey Dashboard
   • Install a fresh copy from revolt.ly/download following the Installation Guide

Sidebar Not Appearing

Solutions:

1. Refresh the page - Press F5 or Ctrl+R

2. Check the URL — Revolt only activates on supported course domains:

   • Edgenuity: *.edgenuity.com, *.learn.edgenuity.com
   • EdgeX: student.ex.edgenuity.com
   • Edmentum: courseware.edmentum.com, study.edmentum.com
   • Subject: app.subject.com (see Subject)
   • FLVS: vsa.flvs.net, learn.flvs.net (see FLVS)
   • Brightspace: tda.brightspace.com, TRECA Digital Academy only (see Brightspace)

3. Disable conflicting extensions and scripts - Other automation extensions or scripts, and the old RevoltX extension, may conflict with Revolt

---

License Issues

Invalid License Key

Symptoms:

• "Invalid key" error when activating
• Features remain locked

Solutions:

1. Check for typos - Copy-paste your key directly from your purchase email

2. Verify key status - Visit revolt.ly/key to check your license

3. Check expiration - Your key may have expired

4. Contact support - If issues persist, reach out on Discord

License Not Syncing

Solutions:

1. Log out and back in - Settings → Log Out, then log back in

2. Reset the script's saved data

   • Open the Tampermonkey Dashboard, open the REVOLT script, and go to its Storage tab
   • Clear the stored values, then reload the course tab and sign in again

---

Feature Issues

Auto Quiz Not Working

Symptoms:

• Quiz answers not appearing
• "No answers found" message

Solutions:

1. Wait for the quiz to fully load - Some quizzes take time to initialize

2. Check your internet connection - Answer lookup requires an active connection

3. Try Default Mode first - Instant Exam mode may not work on all quiz types

4. Report missing answers - If answers aren't found, they may not be in our database yet

Auto Advance Not Progressing

Solutions:

1. Check activity type - Some activities require manual completion

2. Verify settings

   • Open Settings in the sidebar
   • Check that Auto Advance is set to your preferred mode

3. Check for blocking elements - Pop-ups or modals may block advancement

Auto Assignment Stuck

Solutions:

1. Refresh the page - Sometimes the frame state gets corrupted

2. Complete one question manually - This can "unstick" the automation

3. Check for interactive elements - Drag-drop or drawing activities aren't supported

FLVS Logged Out or Stopped

Solutions:

1. Sign back in - FLVS sessions last about 2 hours. Sign in at vsa.flvs.net, open the course with COURSE, and turn Auto Advance on again

2. Read the message - "This exam needs your teacher's password", "Another file is already attached", "This exam needs you" and "Finish the remaining questions on this page and submit" each mean Revolt is waiting for you. See FLVS troubleshooting

Brightspace Signed Out or Stopped

Solutions:

1. Sign back in - "No Session Found", "Sign in to Brightspace" or "You were signed out" means Revolt can't see your TDA sign-in. Sign in at tda.brightspace.com and Auto Advance picks up where it left off

2. Check the school - Only TRECA Digital Academy's Brightspace is supported. Other schools' Brightspace sites won't load Revolt

3. Read the message - "Take this quiz yourself", "N questions need you", "Answers are not saving" and "Needs Mark as Complete" each mean Revolt is waiting for you. See Brightspace troubleshooting

---

Performance Issues

Revolt Running Slowly

Solutions:

1. Close unnecessary tabs - Each course tab runs Revolt

2. Disable unused features - Turn off features you're not using

3. Update your browser - Ensure you're on the latest version

4. Check system resources - Close other heavy applications

High CPU Usage

Solutions:

1. Disable video-related features - Video dimmer and mute can be CPU-intensive

2. Reduce active features - Only enable what you need

---

Connection Issues

"Unable to Connect to Server"

Solutions:

1. Check your internet - Ensure you have an active connection

2. Check API status - Our servers may be undergoing maintenance

3. Disable VPN - Some VPNs block our API endpoints

4. Check firewall - Ensure api.revolt.ly is not blocked

Answers Taking Too Long

Solutions:

1. Check your connection speed - Slow internet affects lookup time

2. Try again later - Server load varies throughout the day

---

Remote Control Issues

Tab missing, blank picture, HD view not starting, or taps in the wrong place

The Remote Control troubleshooting section covers these step by step. The two most common fixes:

1. Sign in with Login with Account on the course tab. Tabs activated with a license key never appear on the Control page.
2. Use HD view when the picture is blank or out of date. It shows videos and embedded players that the standard view cannot.

---

Still Need Help?

If you couldn't find a solution:

When reporting issues, please include:

• Your browser and version
• The specific course URL / activity type (Edgenuity, EdgeX, Edmentum, Subject, FLVS, or Brightspace)
• Screenshots of any error messages
• Steps to reproduce the issue