Settings Configuration

Settings & Configuration

This guide explains all available settings in AkademiTrack and how to customize the application to your preferences.

Accessing Settings

To open the settings window:

1. Click the "Innstillinger" (Settings) button in the main window
2. The settings window will open with multiple configuration sections

General Settings

Show Activity Log

What it does: Shows or hides the activity log panel in the main window.

Options:

• Enabled (default): Log panel is visible
• Disabled: Log panel is hidden, more space for main content

When to use:

• Enable if you want to monitor what AkademiTrack is doing
• Disable if you prefer a cleaner interface and trust the notifications

Detailed Logging

What it does: Enables DEBUG-level log messages for troubleshooting.

Options:

• Enabled: Shows detailed technical information
• Disabled (default): Shows only important messages (INFO, WARNING, ERROR)

When to use:

• Enable when troubleshooting issues
• Enable when reporting bugs to developers
• Disable for normal use to reduce log clutter

What you'll see with detailed logging:

• API request details
• Response data from iSkole
• Internal timing calculations
• Step-by-step processing information

Start with System

What it does: Automatically launches AkademiTrack when your computer starts.

Options:

• Enabled: App starts at system boot
• Disabled (default): You must manually launch the app

When to use:

• Enable for fully automated attendance registration
• Combine with "Auto-start Automation" for hands-off operation
• Disable if you only want to use AkademiTrack occasionally

Note: Currently not working on Linux (known issue).

Automation Settings

Auto-start Automation

What it does: Automatically starts attendance monitoring when AkademiTrack launches.

Options:

• Enabled: Automation begins immediately on app launch
• Disabled (default): You must click "Start automatisering" manually

When to use:

• Enable for completely hands-off operation
• Great when combined with "Start with System"
• Disable if you want manual control over when monitoring begins

How it works:

• App launches → Immediately begins login and monitoring
• No need to click any buttons
• Perfect for "set it and forget it" usage

Saved Login Credentials

What it does: Manage your stored Feide username, password, and school.

Options:

• View currently saved school name
• Change credentials
• Update password if changed

To change credentials:

1. Click "Endre innloggingsopplysninger" (Change login credentials)
2. Enter new school, username, or password
3. Click "Lagre" (Save)
4. Credentials are re-encrypted and stored

When to change:

• If you change your Feide password
• If you transfer to a different Akademiet school
• If login is failing (verify credentials are correct)

Security note: All credentials are encrypted before storage.

Saving Settings

Auto-save: Most settings are saved automatically when changed.

Manual save: Some settings may require clicking a "Lagre" (Save) button.

Settings location:

• Windows: C:\Users\[YourUsername]\AppData\Roaming\AkademiTrack\settings.json
• macOS: ~/Library/Application Support/AkademiTrack/settings.json
• Linux: ~/.config/AkademiTrack/settings.json

Recommended Configurations

For Hands-Off Users

Perfect for "set it and forget it" operation:

• ✅ Start with System: Enabled
• ✅ Auto-start Automation: Enabled
• ✅ Show Activity Log: Disabled (cleaner interface)
• ✅ Detailed Logging: Disabled

Result: App starts with your computer, begins monitoring automatically, minimal interface.

For Power Users

For those who want visibility and control:

• ✅ Start with System: Disabled (manual launch)
• ✅ Auto-start Automation: Disabled (manual start)
• ✅ Show Activity Log: Enabled
• ✅ Detailed Logging: Enabled

Result: Full control, maximum visibility into operations, manual control over everything.

For Troubleshooting

When diagnosing issues:

• ✅ Show Activity Log: Enabled
• ✅ Detailed Logging: Enabled
• Check logs carefully for error messages

Result: Maximum information for identifying problems.

For Normal Daily Use (Default)

Balanced configuration:

• ✅ Start with System: Disabled
• ✅ Auto-start Automation: Disabled
• ✅ Show Activity Log: Enabled
• ✅ Detailed Logging: Disabled

Result: You launch the app when needed, click to start, can see what's happening, not overwhelmed with details.

Resetting Settings

To reset all settings to defaults:

Manual reset:

1. Close AkademiTrack completely
2. Delete the settings file (see "Settings location" above)
3. Relaunch AkademiTrack
4. All settings will be reset to defaults
5. You'll need to reconfigure your Feide credentials

What gets reset:

• All preferences return to defaults
• Saved credentials are deleted
• You'll go through First Time Setup again

What stays:

• Application installation
• Log files (until auto-cleanup)

Settings Backup

To backup your settings and credentials:

1. Locate your settings folder (see "Settings location" above)
2. Copy the entire AkademiTrack folder
3. Store the copy somewhere safe
4. To restore, replace the folder with your backup

Useful when:

• Reinstalling your operating system
• Moving to a new computer
• Testing different configurations

Advanced Configuration

Some settings can be manually edited in the settings.json file:

Warning: Manual editing can break AkademiTrack. Only do this if you know what you're doing.

To manually edit:

1. Close AkademiTrack completely
2. Open the settings file in a text editor
3. Make changes (valid JSON required)
4. Save the file
5. Relaunch AkademiTrack

Common manual edits:

• Adjusting monitoring intervals
• Modifying notification durations
• Changing log retention periods

---

Next Steps

Now that you've configured AkademiTrack to your preferences:

• Read the User Guide to start using the application
• Check Troubleshooting if issues arise
• Visit FAQ for common questions

---

Need Help?

If you have questions about settings:

• Check the FAQ page
• Visit the Troubleshooting page
• Create an issue on GitHub
• Email: cyberbrothershq@gmail.com
• Website: cybergutta.github.io/AkademietTrack