Installation Guide

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:

# You can download the install.sh file in assets

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

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

Linux If installed with install.sh:

sudo rm -rf /opt/akademitrack
sudo rm /usr/share/applications/akademitrack.desktop
sudo rm /usr/local/bin/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