Troubleshooting

Troubleshooting

This guide helps you solve common problems with AkademiTrack.

General Troubleshooting Steps

Before diving into specific issues, try these general steps:

1. Restart AkademiTrack - Close completely and relaunch
2. Check internet connection - Ensure you have stable internet
3. Enable detailed logging - Go to Settings → Enable "Detailed Logging"
4. Check the activity log - Look for error messages
5. Verify credentials - Ensure your Feide login information is correct

---

Login and Authentication Issues

Problem: "Login failed" or "Invalid credentials"

Possible causes:

• Incorrect username or password
• Wrong school selected
• Feide account locked or expired
• Network connectivity issues

Solutions:

1. Verify your credentials by logging into iSkole directly in a web browser
2. Check that you entered your full email address as username
3. Make sure you selected the correct school from the dropdown
4. Try changing your password in Settings → Automation
5. Contact your school IT support if account is locked

Problem: "Connection timeout" during login

Possible causes:

• Poor internet connection
• Feide servers are down
• Firewall blocking connection

Solutions:

1. Check your internet connection
2. Try again in a few minutes
3. Check if other websites are accessible
4. Disable VPN if using one
5. Check firewall settings (allow AkademiTrack)

Problem: Login succeeds but then fails later

Possible causes:

• Session expired
• Cookies cleared
• Network interruption

Solutions:

1. Stop and restart automation
2. Credentials will be refreshed automatically
3. Check for network stability issues

---

Schedule and Session Detection Issues

Problem: "No STU sessions found for today"

Possible causes:

• You genuinely have no STU sessions today
• Schedule not updated in iSkole
• Wrong date/time on your computer

Solutions:

1. Check your schedule in iSkole directly - do you have STU today?
2. Verify your computer's date and time are correct
3. If you do have STU sessions, try restarting automation
4. Contact developers if sessions exist but aren't detected

Problem: "All sessions have conflicts"

Possible causes:

• STU sessions overlap with other classes
• This is normal behavior

Solutions:

• This is expected - AkademiTrack won't register for sessions that conflict
• The app correctly identifies that you're in another class
• No action needed - this protects you from double-booking
• Check your schedule to confirm overlaps

Problem: Sessions detected but registration fails

Possible causes:

• Registration window not actually open
• iSkole API issues
• Network problems during registration

Solutions:

1. Check the exact error message in the activity log
2. Enable detailed logging for more information
3. Try manual registration in iSkole to see if it works
4. Report the issue with logs if it persists

---

Automation Issues

Problem: Automation stops unexpectedly

Possible causes:

• Network disconnection
• AkademiTrack crashed
• Session expired
• Computer went to sleep

Solutions:

1. Restart automation
2. Check activity log for error messages before it stopped
3. Keep computer awake while monitoring
4. Ensure stable internet connection
5. Report crash logs if application crashed

Problem: Automation doesn't start when clicking button

Possible causes:

• Credentials not configured
• Already running in background
• Application error

Solutions:

1. Check if credentials are saved (Settings → Automation)
2. Look for status messages indicating it's already running
3. Restart AkademiTrack
4. Check activity log for error messages

Problem: Auto-start automation doesn't work

Possible causes:

• Feature disabled in settings
• Credentials not saved
• Known issue on Linux

Solutions:

1. Check Settings → Automation → "Auto-start Automation" is enabled
2. Verify credentials are saved
3. On Linux: This is a known bug (see Known Issues below)
4. On Windows/macOS: Restart the app to test

---

Notification Issues

Problem: Not receiving notifications

Possible causes:

• System notifications disabled
• Focus mode enabled
• Notification settings in OS

Solutions:

Windows:

1. Go to Settings → System → Notifications
2. Ensure notifications are enabled for AkademiTrack
3. Check Focus Assist isn't blocking notifications

macOS:

1. Go to System Preferences → Notifications
2. Find AkademiTrack in the list
3. Ensure "Allow Notifications" is checked
4. Set alert style to "Alerts" or "Banners"

Linux:

1. Check your desktop environment's notification settings
2. Ensure notification daemon is running
3. Test with other apps to confirm notifications work

Problem: Too many notifications

Possible causes:

• Detailed logging enabled
• Multiple events happening simultaneously

Solutions:

1. Disable "Detailed Logging" in settings
2. This is normal behavior - each registration triggers a notification
3. Notifications will stop when automation completes

---

Performance Issues

Problem: Application is slow or unresponsive

Possible causes:

• Low system resources
• Network issues
• Large log files

Solutions:

1. Close other applications to free up memory
2. Clear old log files (they're automatically cleaned but can accumulate)
3. Check network speed
4. Restart your computer

Problem: High CPU usage

Possible causes:

• Active monitoring of multiple sessions
• Browser automation in progress
• This is usually temporary

Solutions:

1. CPU usage should be low when idle
2. Higher usage is normal during active monitoring
3. If constantly high, restart the application
4. Report persistent high usage as a bug

---

Platform-Specific Issues

Windows Issues

Problem: Windows Defender blocking the application

Solution:

1. Click "More info" in the SmartScreen dialog
2. Click "Run anyway"
3. Or add an exclusion in Windows Defender for AkademiTrack

Problem: Application won't start

Solution:

1. Right-click AkademiTrack.exe → Properties
2. Check "Unblock" if present
3. Install .NET 9.0 runtime if prompted

macOS Issues

Problem: "AkademiTrack.app is damaged"

Solution:

• Run: xattr -cr /path/to/AkademiTrack.app
• See Installation Guide for details

Problem: "Cannot open from unidentified developer"

Solution:

1. Right-click the app → Open
2. Click "Open" in the dialog
3. Or go to Security & Privacy and click "Open Anyway"

Linux Issues

Problem: Application won't launch

Solution:

1. Ensure it's executable: chmod +x AkademiTrack
2. Check you have required dependencies
3. Run from terminal to see error messages: ./AkademiTrack

Problem: Auto-start doesn't work

Solution:

• This is a known issue
• Manually launch AkademiTrack until fixed in future update

---

Data and Privacy Issues

Problem: Want to clear all data

Solution:

Windows:

1. Close AkademiTrack
2. Delete: C:\Users\[YourUsername]\AppData\Local\AkademiTrack

macOS:

1. Close AkademiTrack
2. Delete: ~/Library/Application Support/AkademiTrack

Linux:

1. Close AkademiTrack
2. Delete: ~/.config/AkademiTrack

Problem: Forgot Feide password

Solution:

• This is a Feide/school issue, not AkademiTrack
• Contact your school IT support
• Use Feide password reset if available
• Once reset, update in AkademiTrack Settings

---

Getting More Help

If your issue isn't covered here:

1. Check the Activity Log

Enable detailed logging and look for specific error messages.

2. Search Existing Issues

Visit GitHub Issues to see if others have reported the same problem.

3. Create a New Issue

If your problem is new:

1. Go to GitHub Issues
2. Click "New Issue"
3. Describe the problem clearly
4. Include:
   • Your operating system
   • AkademiTrack version
   • Steps to reproduce
   • Relevant log messages (enable detailed logging)
   • Screenshots if applicable

4. Contact Developers

• Email: cyberbrothershq@gmail.com
• Website: cybergutta.github.io/AkademietTrack
• GitHub: @CyberNilsen and @CyberHansen

What to Include in Bug Reports

• Operating system and version
• AkademiTrack version
• Detailed description of the issue
• Steps to reproduce
• Activity log (with detailed logging enabled)
• Screenshots showing the problem
• What you've already tried

---

Diagnostic Information

To gather diagnostic information for support:

1. Enable "Detailed Logging" in Settings
2. Reproduce the issue
3. Copy the activity log
4. Note your:
   • OS and version
   • AkademiTrack version (check Settings or About)
   • When the issue started
   • What you were doing when it happened

This information helps developers fix issues quickly.

---

Additional Resources

• Installation Guide
• User Guide
• Settings & Configuration
• FAQ