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)
• Internet Connection: Stable internet connection required
• Disk Space: At least 100 MB of free space
• 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-windows.zip
• macOS: AkademiTrack-macos.zip
• Linux: AkademiTrack-linux.zip

---

Windows Installation

Step 1: Download

Download AkademiTrack-windows.zip from the releases page.

Step 2: Extract

Right-click the downloaded ZIP file and select "Extract All..." Choose a location where you want to install AkademiTrack (e.g., C:\Program Files\AkademiTrack or your Desktop).

Step 3: Run the Application

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

Step 4: 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.

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

Step 1: Download

Download AkademiTrack-macos.zip from the releases page.

Step 2: Extract

Double-click the downloaded 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:

1. Open Terminal (Applications → Utilities → Terminal)
2. Run this command:

xattr -cr ~/Downloads/AkademiTrack.app

3. 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 the Application

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"

1. Go to System Preferences → Security & Privacy
2. Click "Open Anyway" next to the AkademiTrack message
3. Or right-click the app and select "Open", then click "Open" in the dialog

---

Linux Installation

Step 1: Download

Download AkademiTrack-linux.zip from the releases page.

Step 2: Extract

Open a terminal and navigate to your Downloads folder:

cd ~/Downloads
unzip AkademiTrack-linux.zip

Or use your file manager to extract the ZIP file.

Step 3: Make Executable

Navigate to the extracted folder and make the application executable:

cd AkademiTrack
chmod +x ./AkademiTrack

Step 4: Run the Application

Run the application from the terminal:

./AkademiTrack

Optional: Create Desktop Entry

To launch AkademiTrack from your application menu:

1. Create a .desktop file:

nano ~/.local/share/applications/akademitrack.desktop

2. Add this content (adjust the path to where you extracted AkademiTrack):

[Desktop Entry]
Type=Application
Name=AkademiTrack
Comment=Automated STU attendance registration
Exec=/path/to/AkademiTrack/AkademiTrack
Icon=/path/to/AkademiTrack/icon.png
Terminal=false
Categories=Education;Utility;

3. Save and close (Ctrl+X, then Y, then Enter)

Known Linux Issues

• Auto-Start Bug: The "Start with system" feature doesn't currently work on Linux. This will be fixed in a future update.

---

First Launch

After installation, when you first launch AkademiTrack:

1. The application will open to the First Time Setup screen
2. You'll need to configure your Feide credentials
3. Follow the First Time Setup guide for detailed instructions

---

Updating AkademiTrack

AkademiTrack checks for updates automatically every 30 minutes. When an update is available:

1. A notification will appear in the application
2. Click the notification or go to Settings → Updates
3. Click "Download and Install"
4. The application will update and restart automatically

You can also manually check for updates in the Settings window.

---

Uninstalling AkademiTrack

Windows

1. Delete the AkademiTrack folder
2. Delete the data folder: C:\Users\[YourUsername]\AppData\Local\AkademiTrack

macOS

1. Delete AkademiTrack.app from Applications
2. Delete the data folder: ~/Library/Application Support/AkademiTrack

Linux

1. Delete the AkademiTrack folder
2. Delete the data folder: ~/.config/AkademiTrack
3. Remove the desktop entry: rm ~/.local/share/applications/akademitrack.desktop

---

Next Steps

Now that AkademiTrack is installed:

1. Complete the First Time Setup to configure your credentials
2. Read the User Guide to learn how to use all features
3. 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
• Contact the developers directly