Automated attendance registration for STU sessions at Akademiet schools
Features • Installation • Quick Start • Documentation • Support
AkademiTrack is a desktop automation tool designed for students at Akademiet schools in Norway. It automatically monitors your schedule and registers attendance for STU (Selvstendige Terminoppgaver / Independent Term Projects) sessions when registration windows open, eliminating the need to manually track and register throughout the day.
- Dashboard View - Real-time overview of today's STU sessions, weekly/monthly attendance, and overtime tracking
- Next Class Display - Shows your current or next scheduled class with room information
- Weekly Attendance Tracker - Visual breakdown of attendance by day with percentage tracking
- Monthly Statistics - Track your monthly attendance rate and registered sessions
- Overtime/Undertime Tracking - Monitor your attendance balance with color-coded status
- Smart Caching - Instant dashboard loading with background refresh for better performance
- Sleep Detection - Automatically refreshes data when system wakes from sleep
- Enhanced Notifications - Priority-based notification queue with system integration
- Persistent Cache System - 24-hour TTL cache with automatic cleanup
- Optimized Data Loading - Parallel API requests with individual timeouts
- Better Error Recovery - Automatic retry mechanisms with exponential backoff
- Improved Logging - Comprehensive activity logs with debug mode
- Health Diagnostics - Built-in system health checks and troubleshooting tools
- ✅ Automatic Authentication - Secure Feide login with encrypted credential storage using Selenium WebDriver
- 🔍 Intelligent Session Detection - Identifies STU sessions from your daily schedule
⚠️ Conflict Detection - Automatically skips sessions that overlap with regular classes- ⚡ Real-Time Registration - Registers attendance the moment windows open
- 📊 Efficient Monitoring - Optimized API usage with smart caching
- 📈 Live Dashboard - Real-time view of today's STU sessions and registration status
- 📅 Weekly Overview - Visual breakdown of attendance by day with completion tracking
- 📊 Monthly Statistics - Track attendance rates and session counts
- ⏰ Next Class Widget - Shows current or upcoming class with time and room info
- ⚖️ Overtime Tracking - Monitor attendance balance with color-coded indicators
- 💾 Smart Caching - Instant load times with background data refresh
- 🚀 Auto-Start Options - Launch with system and/or begin automation automatically
- 🎯 Start Minimized - Option to start in system tray for unobtrusive operation
- 📝 Activity Logging - Comprehensive logs with optional detailed debug mode
- 🔔 Priority Notifications - Queue-based system notifications with importance levels
- 💻 Cross-Platform - Native support for Windows, macOS, and Linux
- 🌙 Sleep Detection - Automatically refreshes after system wake
- 🔐 Encrypted Storage - Industry-standard encryption for credentials (ProtectedData API)
- 🏥 Health Diagnostics - Built-in system health checks and troubleshooting
- 📤 Data Export - Export logs and settings for backup or support
- ⚙️ Flexible Settings - Customizable school hours, notification preferences, and automation options
Option 1: Standalone Executable (Recommended)
- Download
AkademiTrack.exefrom releases - Run the single-file executable - no installation required!
Option 2: Portable ZIP
- Download
AkademiTrack-win-Portable.zipfrom releases - Extract to your preferred location
- Run
AkademiTrack.exe
- Download
AkademiTrack-osx-Setup.pkgfrom releases - Install the package and launch from Applications
- If macOS blocks the app, remove quarantine:
xattr -cr /Applications/AkademiTrack.app
- Download
AkademiTrack.AppImagefrom releases - Make executable:
chmod +x ./AkademiTrack.AppImage
- Run:
./AkademiTrack.AppImage
Note: ChromeDriver is automatically downloaded and managed by the app on first run.
- Launch AkademiTrack
- 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
-
Dashboard View - See your attendance overview at a glance:
- Today's STU sessions (registered/total)
- Current or next class information
- Weekly attendance breakdown
- Monthly statistics
- Overtime/undertime balance
-
Click "Start automatisering" to begin monitoring
-
AkademiTrack will automatically:
- Log in to iSkole using Selenium WebDriver
- Fetch and cache today's schedule
- Identify STU sessions
- Skip sessions with conflicts
- Register attendance when windows open
- Update dashboard in real-time
-
Monitor progress in the activity log
-
Receive system notifications for successful registrations
- 📖 Wiki - Comprehensive documentation
- 🛠️ Installation Guide - Detailed setup instructions
- 📘 User Guide - Complete usage documentation
- 🔧 Troubleshooting - Common issues and solutions
- ❓ FAQ - Frequently asked questions
| Requirement | Specification |
|---|---|
| OS | Windows 10/11, macOS 10.15+, or Linux (Ubuntu 20.04+, Fedora 35+) |
| .NET Runtime | .NET 9.0 (included in installers) |
| Internet | Stable connection required |
| Storage | ~200 MB free space |
| Browser | ChromeDriver (automatically managed by WebDriverManager) |
| Account | Valid iSkole account at an Akademiet school |
AkademiTrack takes your security seriously:
- 🏠 Local Storage Only - All data stored exclusively on your device
- 🔐 Encrypted Credentials - Uses System.Security.Cryptography.ProtectedData for Windows, Keychain for macOS
- 🔒 Secure Authentication - Selenium-based browser automation with official Feide SSO
- 📊 No Telemetry - No usage tracking or data collection (optional analytics service exists but is not active)
- ✅ Official APIs - Only communicates with iSkole and Feide servers
- 🔓 Open Source - Code available for community review and security audits
Read our Security Policy for vulnerability reporting.
# Clone repository
git clone https://github.com/CyberGutta/AkademiTrack.git
cd AkademiTrack
# Build and run
dotnet restore
dotnet build
dotnet runContributions are welcome! Please read our Contributing Guidelines and Code of Conduct before submitting pull requests.
- Enhanced error recovery mechanisms
- Desktop widgets for quick status view
See CHANGELOG.md for version history.
- 📖 Documentation: Wiki
- 🐛 Issues: GitHub Issues
- 💭 Discussions: GitHub Discussions
- 📧 Email: cyberbrothershq@gmail.com
- 🌐 Website: cybergutta.github.io/AkademietTrack
| Component | Technology |
|---|---|
| Language | C# (.NET 9.0) |
| UI Framework | Avalonia UI 11.3.11 |
| Authentication | Selenium WebDriver 4.40.0 with ChromeDriver |
| Architecture | MVVM pattern with Dependency Injection |
| Security | System.Security.Cryptography.ProtectedData 10.0.2 (Windows), Keychain (macOS) |
| Caching | Custom TTL-based cache service with automatic cleanup |
| Notifications | OsNotifications 1.1.3 for native system notifications |
| HTTP Client | System.Net.Http with retry logic |
This project is licensed under the MIT License - see the LICENSE file for details.
AkademiTrack is designed to assist students with legitimate attendance registration. Users are responsible for ensuring their use complies with school policies and academic integrity standards. This is not an official Akademiet or iSkole product.
Built for the Akademiet student community. Special thanks to all contributors and users providing feedback.
Note for Norwegian speakers: While the documentation is in English, the application interface is in Norwegian to match the iSkole system used at Akademiet schools.
Made with ❤️ for Akademiet students