First Time Setup

Installation Guide

This guide will help you install AkademiTrack on Windows, macOS, or Linux.

System Requirements

Before installing, make sure your system meets these requirements:

• Operating System: Windows 10/11, macOS 10.15+, or Linux (Ubuntu 20.04+, Fedora 35+, or similar)
• .NET Runtime: .NET 9.0 (included in installers)
• Internet Connection: Stable internet connection required
• Storage: ~200 MB free space
• Browser: ChromeDriver (automatically managed by WebDriverManager)
• Account: Valid iSkole account at an Akademiet school

Download AkademiTrack

Download the latest version from the releases page:

Latest Release: https://github.com/CyberGutta/AkademiTrack/releases/latest

Choose the file for your operating system:

• Windows: AkademiTrack.exe (standalone) or AkademiTrack-Setup.exe (installer) or AkademiTrack-win-Portable.zip
• macOS: AkademiTrack-osx-Setup.pkg (installer) or AkademiTrack-{version}-osx-Portable.zip
• Linux: AkademiTrack (standalone binary) or AkademiTrack-linux-Portable.tar.gz

---

Windows Installation

Option 1: Standalone Executable (Recommended)

Step 1: Download

Download AkademiTrack.exe from the releases page.

Step 2: Run

Double-click AkademiTrack.exe to launch - no installation required!

Step 3: Windows Defender Warning (if prompted)

If Windows Defender SmartScreen appears:

1. Click "More info"
2. Click "Run anyway"

This happens because the app isn't signed with a Microsoft certificate yet. Your data is safe and the application is open source.

Option 2: Windows Installer

Step 1: Download

Download AkademiTrack-Setup.exe from the releases page.

Step 2: Run Installer

Double-click the installer and follow the setup wizard.

Step 3: Launch

The installer will create desktop shortcuts and start menu entries automatically.

Option 3: Portable ZIP

Step 1: Download

Download AkademiTrack-win-Portable.zip from the releases page.

Step 2: Extract

Right-click the ZIP file and select "Extract All..." Choose your preferred location (e.g., C:\Program Files\AkademiTrack or your Desktop).

Step 3: Run

Navigate to the extracted folder and double-click AkademiTrack.exe.

Optional: Create a Shortcut

Right-click AkademiTrack.exe and select "Create shortcut". Move the shortcut to your Desktop or taskbar for easy access.

---

macOS Installation

Option 1: PKG Installer (Recommended)

Step 1: Download

Download AkademiTrack-osx-Setup.pkg from the releases page.

Step 2: Install

Double-click the .pkg file and follow the installation wizard. The app will be installed to /Applications/AkademiTrack.app.

Step 3: Remove Quarantine (if needed)

If macOS blocks the app, open Terminal and run:

xattr -cr /Applications/AkademiTrack.app

Step 4: Launch

Open AkademiTrack from your Applications folder or Launchpad.

Option 2: Portable ZIP

Step 1: Download

Download AkademiTrack-{version}-osx-Portable.zip from the releases page.

Step 2: Extract

Double-click the ZIP file. It will extract to AkademiTrack.app in your Downloads folder.

Step 3: Remove Quarantine Attributes

macOS applies quarantine attributes to downloaded applications. You must remove these before running:

Open Terminal (Applications → Utilities → Terminal) and run:

xattr -cr ~/Downloads/AkademiTrack.app

If you moved the app to a different location, replace ~/Downloads/ with the actual path.

**Step 4: Move to Applications (Optional)

Drag AkademiTrack.app to your Applications folder for easier access.

**Step 5: Run

Double-click AkademiTrack.app to launch.

Troubleshooting macOS Issues "AkademiTrack.app is damaged and can't be opened"

This means you didn't remove the quarantine attributes. Run the xattr command from Step 3.

"AkademiTrack.app can't be opened because it is from an unidentified developer"

Go to System Preferences → Security & Privacy Click "Open Anyway" next to the AkademiTrack message Or right-click the app and select "Open", then click "Open" in the dialog Linux Installation Option 1: Standalone Binary (Recommended) Step 1: Download

Download AkademiTrack (standalone binary) from the releases page.

**Step 2: Make Executable

Open a terminal in your Downloads folder and run:

chmod +x ./AkademiTrack

**Step 3: Run

Launch the application:

./AkademiTrack

Option 2: Portable Tarball with System Installation

**Step 1: Download

Download AkademiTrack-linux-Portable.tar.gz from the releases page.

**Step 2: Extract

Open a terminal and navigate to your Downloads folder:

cd ~/Downloads
tar -xzf AkademiTrack-linux-Portable.tar.gz

Step 3: Install System-Wide (Optional)

To install to /opt/akademitrack with desktop integration:

cd AkademiTrack
sudo ./install.sh

After installation, you can:

Run akademitrack from any terminal Launch from your application menu Step 4: Run Portable (Without Installation)

If you prefer not to install system-wide:

cd AkademiTrack
chmod +x ./AkademiTrack
./AkademiTrack

First Launch

After installation, when you first launch AkademiTrack:

• The application will open to the First Time Setup screen
• Select your Akademiet school from the dropdown
• Enter your Feide credentials (email and password)
• Click "Lagre og fortsett" (Save and continue)
• Your encrypted credentials are now saved for automatic login

Uninstalling AkademiTrack

Windows If installed with installer:

Go to Settings → Apps → Installed apps Find AkademiTrack and click Uninstall If using portable/standalone:

Delete the AkademiTrack folder or executable Delete the data folder: C:\Users[YourUsername]\AppData\Local\AkademiTrack

macOS If installed with PKG:

**Delete AkademiTrack.app

• Delete the LaunchAgent: ~/Library/LaunchAgents/com.CyberBrothers.akademitrack.plist
• Delete the data folder: ~/Library/Application Support/AkademiTrack

If using portable:

• Delete AkademiTrack.app from wherever you placed it
• Delete the data folder: ~/Library/Application Support/AkademiTrack

Linux If installed with install.sh:

sudo rm -rf /opt/akademitrack
sudo rm /usr/share/applications/akademitrack.desktop
sudo rm /usr/local/bin/akademitrack

If using portable/standalone:

• Delete the AkademiTrack folder or binary
• Delete the data folder: ~/.config/AkademiTrack

Next Steps

Now that AkademiTrack is installed:

• Complete the First Time Setup to configure your credentials
• Read the User Guide to learn how to use all features
• Check out Settings & Configuration to customize your experience

Need Help?

If you encounter any issues during installation:

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