Genesis
Smart Study Planner — v1.1.5
Codename: Genesis
📖 Overview
Genesis represents a significant evolution in the Smart Study Planner experience, focusing on visual refinement, usability, and application polish rather than introducing entirely new productivity workflows. While Momentum delivered the project's first complete feature set, Genesis transforms those capabilities into a modern, responsive, and immersive desktop application.
This release introduces an extensive UI/UX overhaul featuring animated backgrounds, custom sound effects, improved accessibility, expanded localization, enhanced account management, and numerous quality-of-life improvements. Every existing feature has been refined to create a smoother, more intuitive experience while maintaining the application's lightweight, offline-first philosophy.
In addition to visual improvements, considerable effort was invested in improving stability, resolving interface inconsistencies, and eliminating edge-case crashes identified during internal testing.
🎯 Objectives
This milestone was developed with the following goals:
- Modernize the desktop user experience.
- Introduce motion and audio throughout the application.
- Improve accessibility and personalization.
- Expand localization support.
- Strengthen application stability.
- Refine existing workflows without changing their core functionality.
✨ Added
✨ Animated Background System
Introduced a custom ParticleCanvas rendering engine that generates animated particle constellations throughout the application.
The background system now appears on:
- Login screen
- Registration screen
- Password recovery
- Focus Timer
- Credits screen
Features include:
- Theme-aware colors
- Approximately 25 FPS rendering
- Automatic pause when inactive
- No external image assets required
This creates a more modern desktop experience while maintaining excellent performance.
🔊 Custom Sound Engine
Implemented a bespoke sound system replacing generic operating system notification sounds.
New synthesized audio cues include:
- Click
- Success
- Error
- Notification
All sounds are stored within the application's assets and provide a consistent audio identity.
🎵 Ambient Audio Controls
The Focus Timer now includes a complete ambient audio playback system.
Users can:
- Play or pause ambient sounds
- Adjust playback volume
- Select soundscapes
- View a live animated waveform synchronized with playback
These additions provide a more immersive and distraction-free study environment.
⚙️ Sound Preferences
Added a dedicated Sound & Feedback settings section.
Users can now:
- Enable or disable sound effects
- Preserve sound preferences between sessions
Settings are automatically restored whenever the application launches.
👤 Improved Login Experience
The application now remembers the last username or email used during login.
Benefits include:
- Faster authentication
- Reduced typing
- Automatic cursor placement in the password field
👥 Registered Account Quick-Pick
Added account selection chips to the login screen.
Users can quickly select a previously registered account without manually entering their username or email.
📝 Update Profile
Introduced a new Update Profile panel within Settings.
Users can now modify:
- Full Name
- Username
- Email Address
Changes are immediately reflected throughout the application.
👁️ Password Visibility Controls
Added show/hide password controls for password update forms.
Users can now verify entered passwords before confirming changes.
🌍 Expanded Localization
Localization support has been expanded from 10 to 12 languages.
New additions include:
- العربية (Arabic)
- فارسی (Persian)
Both languages include proper right-to-left interface support.
📭 Empty State Screens
Added dedicated empty-state messages throughout the application.
Covered sections include:
- Tasks
- Insights
- Study Timetable
These provide meaningful feedback instead of blank interface panels.
🗑️ Study Group Deletion
Study groups can now be permanently removed.
Deletion automatically cleans:
- Group information
- Members
- Shared tasks
This prevents orphaned data and simplifies workspace management.
🪟 Application Icon
Added a dedicated application icon across the desktop experience.
The icon now appears in:
- Window title bar
- Taskbar
- Packaged executable
🔄 Changed
🎨 Language Selector
Replaced the previous language selection widget with a fully themed ttk.Combobox across all authentication screens and application settings.
🌗 Theme Switching
Theme changes no longer interrupt the user's workflow.
The application now preserves:
- Current screen
- Entered form data
- Navigation state
Users no longer return to the login screen after changing themes.
🔤 Username Standardization
Usernames are now automatically normalized to lowercase during both input validation and database storage.
This guarantees consistent authentication behavior across the application.
🚀 Improved
🎯 Overall User Experience
Every major interface was reviewed and refined to improve consistency, responsiveness, and usability.
Animations, transitions, controls, and visual feedback now behave more predictably throughout the application.
⚡ Performance
Rendering optimizations ensure smooth animations while maintaining low CPU utilization, even on lower-end hardware.
🧹 Interface Consistency
Buttons, forms, colors, navigation components, and layout spacing were standardized to provide a more cohesive desktop experience.
🐞 Fixed
⏱️ Focus Timer
Resolved an issue preventing the Focus Timer from rendering correctly by replacing place() positioning with a grid-based layout.
🎨 Theme Navigation
Fixed an issue where changing themes unexpectedly returned users to the login screen.
Navigation state is now preserved.
⚠️ TclError Exceptions
Resolved intermittent crashes caused by scheduled callbacks executing after widgets had already been destroyed.
Affected components include:
- Study Assistant
- Audio visualizer
📅 Calendar Export
Resolved a TypeError affecting .ics export when handling deadline date objects.
Calendar exports now generate successfully.
📊 Insights Dashboard
Fixed an issue causing the Insights page to appear blank when no task data existed.
Charts now render correctly using zero-value placeholders.
🔊 Asset Resolution
Resolved audio asset loading failures when the application was launched from directories outside the project root.
🎨 Sidebar Visibility
Corrected active sidebar colors in Light Mode to ensure the selected navigation item remains visible.
🏛️ Architecture Progress
Genesis represents the transition from a feature-rich application to a polished desktop product.
Major improvements include:
- Motion design
- Desktop audio framework
- Improved accessibility
- Expanded localization
- Enhanced account management
- Consistent theming
- Greater application stability
- Refined interface interactions
Rather than expanding functionality, this release focuses on perfecting the experience delivered by previous versions.
💻 Compatibility
| Platform | Status |
|---|---|
| Windows | ✅ Verified |
| macOS | 🟢 Supported |
| Linux | 🟢 Supported |
Python: 3.8+
Dependencies:
- Pillow
👥 Contributors
| Name | Role |
|---|---|
| Mohammad Sufiyan Aasim | System Architecture & Documentation |
| Ifrahim Yousuf | UI/UX Design, Animations, Theming, Sound Design & Localization |
🚀 What's Next
The next milestone, Smart Study Planner v1.2.0 — Horizon, focuses on expanding productivity beyond task management by introducing a dedicated Notes Scratchpad, professional repository organization, improved packaging, and open-source documentation standards. While Genesis refined the user experience, Horizon prepares the project for long-term maintainability and public collaboration.