LMS Alternative is a robust desktop application designed to streamline the academic workflow for students and educators. Built with Flet (Python), it functions as a lightweight Learning Management System (LMS) that integrates seamless file management with essential academic tools.

By layering organizational features over Google Drive, this application provides a centralized dashboard where users can manage assignments, track deadlines, and organize course materials without the complexity of traditional LMS platforms. Whether you need to submit assignments, manage shared resources, or simply keep your digital workspace tidy, LMS Alternative offers a simple, efficient solution.

This application serves as a lightweight alternative to traditional Learning Management Systems (LMS), specifically designed to solve common student challenges:

• 📚 Centralized Assignment Management – No more hunting through countless Google Drive links for different subjects and assignments
• ✅ To-Do List with Smart Notifications – Track assignments with due dates and get timely reminders before and after deadlines
• ⏰ Time Tracking – See remaining time for each assignment at a glance
• 🔗 Quick Link Access – Organize and access all your course folders and assignment submission links in one place
• 📂 Subject-Based Organization – Keep everything organized by subject/course for easy navigation

Perfect for students who need a simple, efficient way to manage their academic workload without the complexity of full-featured LMS platforms.

• 📋 Assignment To-Do List – Create and manage assignments with due dates
• 🔔 Smart Notifications – Get reminders before and after assignment due dates
• ⏱️ Time Remaining Tracker – Visual countdown showing time left to complete tasks
• 📚 Subject Organization – Organize assignments and folders by course/subject
• 🔗 Assignment Link Management – Store and quickly access Google Drive submission folders for each assignment

• 🔐 Google OAuth Authentication – Secure login using your Google account
• 📁 Browse & Navigate – Explore your Google Drive folders with an intuitive interface
• 🔍 Search – Quickly find files and folders across your Drive
• 📂 Shared Drives Support – Access and browse shared drives
• 🔗 Paste Drive Links – Open folders/files directly by pasting Google Drive links
• ⭐ Favorites – Save frequently accessed folders organized by category
• 📝 File Operations – Create folders, upload files, rename, and delete
• 💾 Saved Links – Keep a list of important Drive links for quick access
• 🔄 Caching – Smart caching for improved performance and reduced API calls

• Python 3.8 or higher
• Google Cloud Platform project with Drive API enabled
• OAuth 2.0 credentials (credentials.json)

git clone https://github.com/ASTRALLIBERTAD/LMS-alternative.git
cd capstone

python -m venv venv

# Windows
venv\Scripts\activate

# macOS/Linux
source venv/bin/activate

pip install flet google-auth google-auth-oauthlib google-api-python-client

1. Go to Google Cloud Console.

2. Create a new project.

3. In the left sidebar, go to APIs & Services → Library.

4. Search for Google Drive API.

5. Click on Google Drive API → Enable.

6. Go to APIs & Services → Credentials.

7. Click Create Credentials → OAuth 2.0 Client ID.

8. If prompted, configure the OAuth consent screen:

   • Select External for testing or Internal if only for your organization.
   • Fill in App Name, User Support Email, and Developer Email.
   • Save and continue (you can skip scopes for now for basic setup).

9. Back to Create OAuth 2.0 Client ID:

   • Select Desktop App as the application type.
   • Give it a name (e.g., MLS-alternative).
   • Click Create.

10. After creating, click Download JSON.

11. Save it in your project folder, e.g., services/credentials.json.

12. In the left sidebar:

    • APIs & Services → OAuth consent screen

13. Scroll down to the section Test users.

14. Click Add users.

15. Enter the Gmail accounts that will be allowed to use your OAuth app in testing mode:

    • You can add your own Gmail.
    • You can add multiple test accounts if needed.

Run the application:

flet main.py

1. Click "Login with Google"
2. A browser window will open for Google authentication
3. Grant the requested permissions
4. You'll be redirected to the main dashboard

capstone/
├── main.py                 # Application entry point
├── README.md               # Project Overview
├── saved_links.json        # Saved Drive links (auto-generated)
├── favorites.json          # Saved favorites (auto-generated)
├── services/
│   ├── auth_service.py     # Google OAuth authentication
│   ├── drive_service.py    # Google Drive API operations
│   ├── credentials.json    # OAuth credentials (you provide)
│   └── token.pickle        # Auth token (auto-generated)
├── ui/
│   ├── dashboard.py        # Main dashboard UI
│   ├── login.py            # Login screen
│   └── custom_control/     # Custom UI components
└── venv/                   # Virtual environment

The application stores configuration in the following files:

• OAuth tokens are stored locally in token.pickle
• Credentials never leave your device
• Add the following to .gitignore:

  services/credentials.json
  services/token.pickle
  

The app supports pasting links in these formats:

• https://drive.google.com/drive/folders/FOLDER_ID
• https://drive.google.com/file/d/FILE_ID
• https://drive.google.com/...?id=ID

We welcome contributions! Follow these steps to contribute to this project:

Click the Fork button at the top-right of this repository to create your own copy.

git clone https://github.com/<your-username>/LMS-alternative.git 
cd LMS-alternative

3.1 Create Virtual Environment:

python -m venv venv

# Windows
venv\Scripts\activate

# macOS/Linux
source venv/bin/activate

3.2 Install Dependencies:

pip install flet google-auth google-auth-oauthlib google-api-python-client

3.3 Set Up Google Cloud Credentials

1. Go to Google Cloud Console.

2. Create a new project.

3. In the left sidebar, go to APIs & Services → Library.

4. Search for Google Drive API.

5. Click on Google Drive API → Enable.

6. Go to APIs & Services → Credentials.

7. Click Create Credentials → OAuth 2.0 Client ID.

8. If prompted, configure the OAuth consent screen:

   • Select External for testing or Internal if only for your organization.
   • Fill in App Name, User Support Email, and Developer Email.
   • Save and continue (you can skip scopes for now for basic setup).

9. Back to Create OAuth 2.0 Client ID:

   • Select Desktop App as the application type.
   • Give it a name (e.g., MLS-alternative).
   • Click Create.

10. After creating, click Download JSON.

11. Save it in your project folder, e.g., services/credentials.json.

12. In the left sidebar:

    • APIs & Services → OAuth consent screen

13. Scroll down to the section Test users.

14. Click Add users.

15. Enter the Gmail accounts that will be allowed to use your OAuth app in testing mode:

    • You can add your own Gmail.
    • You can add multiple test accounts if needed.

16. Click Save.

git checkout -b feature/amazing-feature

Implement your feature or fix a bug.

git add .
git commit -m "Add amazing feature"

git push origin feature/amazing-feature

Go to your fork on GitHub and click Compare & Pull Request to submit your changes to the original repository.

Tips: Keep branch names descriptive (feature/... or fix/...), write clear commit messages, and make sure your code is tested before submitting.

This project is licensed under the MIT License. See LICENSE for more information.

• Flet – Cross-platform UI framework for Python
• Google Drive API – Cloud storage API