Skip to content

Settings Configuration

Andreas Nilsen edited this page Oct 5, 2025 · 1 revision

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 (Generelt)

Vis aktivitetslogg (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

Detaljert logging (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 med system (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 automatisering" for hands-off operation
  • Disable if you only want to use AkademiTrack occasionally

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

Automation Settings (Automatisering)

Auto-start automatisering (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 med 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

Lagrede innloggingsopplysninger (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.

Update Settings (Oppdateringer)

Automatiske oppdateringssjekker (Automatic Update Checks)

What it does: AkademiTrack checks for new versions every 30 minutes while running.

Options:

  • This is automatic and cannot be disabled
  • Checks happen in the background
  • You'll be notified when updates are available

Sjekk etter oppdateringer (Check for Updates)

What it does: Manually check if a new version is available.

How to use:

  1. Click "Sjekk etter oppdateringer"
  2. AkademiTrack queries GitHub for the latest release
  3. Results are displayed immediately

Possible results:

  • "Du har den nyeste versjonen" (You have the latest version)
  • "Ny versjon tilgjengelig: vX.X.X" (New version available: vX.X.X)

Last ned og installer (Download and Install)

What it does: Downloads and installs the latest version of AkademiTrack.

How it works:

  1. Click "Last ned og installer"
  2. Update downloads in the background
  3. Progress is shown
  4. Application restarts automatically with new version
  5. Your settings and credentials are preserved

Note: Requires internet connection and may take a few minutes.

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 med system: Enabled
  • ✅ Auto-start automatisering: Enabled
  • ✅ Vis aktivitetslogg: Disabled (cleaner interface)
  • ✅ Detaljert logging: Disabled

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

For Power Users

For those who want visibility and control:

  • ✅ Start med system: Disabled (manual launch)
  • ✅ Auto-start automatisering: Disabled (manual start)
  • ✅ Vis aktivitetslogg: Enabled
  • ✅ Detaljert logging: Enabled

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

For Troubleshooting

When diagnosing issues:

  • ✅ Vis aktivitetslogg: Enabled
  • ✅ Detaljert logging: Enabled
  • Check logs carefully for error messages

Result: Maximum information for identifying problems.

For Normal Daily Use (Default)

Balanced configuration:

  • ✅ Start med system: Disabled
  • ✅ Auto-start automatisering: Disabled
  • ✅ Vis aktivitetslogg: Enabled
  • ✅ Detaljert 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 update check 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
  • Contact the developers directly

Clone this wiki locally