A application that forms the extension of the Screetime app, built as a hobby project to reduce eye strain issues: Computer Vision Syndrome
SlideUpon is an Android-based productivity application designed to help users complete tasks efficiently with calculated work-break schedules. The app combines research-based time management techniques with personalized health monitoring to optimize your workflow.
๐ Website: https://sites.google.com/view/screetime/slideupon
- Features
- Time Management Techniques
- Installation
- Usage
- Project Structure
- Configuration
- Dependencies
- Contributing
- License
- Contact
-
Multiple Time Management Algorithms
- AppName Algorithm (Recommended) - Custom algorithm with task categorization
- Pomodoro Technique - Classic 25-minute intervals
- 60/10 Method - 60 minutes of work followed by 10 minutes of mind wandering
-
Smart Break Calculation
- Automatic break duration calculation based on interval length
- Eye strain prevention using the 20-20-20 rule
- Blink rate monitoring and adjustment
- Movement reminders to prevent sedentary behavior
-
Task Categories
- PC or Mobile Related Tasks
- Study Sessions
- Limited Time Tasks
- Mind Wandering Sessions
- Blink Test: Measures your eye blink rate to calculate optimal screen break times
- Flow State Detection: Tests and tracks your maximum focused work duration
- Exhaustion Limit Tracking: Monitors daily usage with three levels (Mild, Moderate, Extreme)
- Habit Maker Reminders:
- Posture correction alerts
- Water drinking reminders
- Walking/movement suggestions
- Real-time Progress Monitoring: Track time spent on different task categories
- Daily Usage Statistics: Monitor today's work duration
- Weekly/Monthly/Fortnightly Reports: Customizable progress tracking periods
- Performance Score: Tracks improvement over time
- Theme Picker: Choose from multiple color palettes and themes (Light/Dark)
- Custom Intervals: Set your own work and break durations
- Auto Timer: Automatically manages multiple intervals with calculated breaks
- Audio Notifications: Custom sound alerts for breaks and interval completion
A proprietary algorithm that adapts to your work type and health metrics:
PC or Mobile Related Tasks:
- Considers screen exposure time
- Factors in blink rate for eye health
- Applies 20-20-20 rule (every 20 minutes, look at something 20 feet away for 20 seconds)
- Includes movement breaks
Study Tasks:
- Optimized for learning and retention
- Includes quick revision prompts (at 80% of interval time)
- Balances focused study with necessary breaks
Limited Time Tasks:
- High-intensity work sessions
- Flexible break scheduling for tight deadlines
- Traditional 25-minute work intervals
- Breaks scale with interval duration
- Every 4th break is extended
- 60 minutes of focused work
- 10 minutes of mind wandering/creative thinking
- Fixed interval structure
- Python 3.9 or higher
- Android device (for mobile deployment) or PC for testing
-
Clone the repository
git clone https://github.com/Steosumit/SlideUpon-Android.git cd SlideUpon-Android -
Install dependencies
pip install -r requirements.txt
-
Run the application
python NewApp.py
For Android deployment, use Buildozer:
buildozer android debug
buildozer android deploy run-
Initial Setup
- Launch the app
- Take the Blink Test to calibrate eye health monitoring
- (Optional) Take the Flow Limit Test to find your optimal focus duration
-
Starting a Work Session
- Navigate to the Main tab
- Select a time management technique from the dropdown
- Choose a task category (if using AppName Algorithm)
- Enter interval duration (in minutes)
- For auto mode: Enable the auto timer switch and enter total duration
- Click START
-
During Work Intervals
- Progress bar shows current interval status
- Timer displays elapsed time (Hours : Minutes : Seconds)
- Today's Use shows cumulative work time
-
Break Management
- Audio notification signals break start
- Dialog shows recommended break duration
- Audio notification signals break end
- Acknowledge dialog to stop reminder beeps
- Flow Limit Test: Determine your maximum sustained focus time
- Theme Picker: Customize app appearance
- Blink Rate: View and update your average blink count
- Audio Settings: Select custom break notification sounds (MP3/WAV)
- View progress by task category
- Track against weekly/monthly/fortnightly goals
- Monitor exhaustion limits
- Adjust progress measurement periods
SlideUpon-Android/
โโโ NewApp.py # Main application file with UI classes
โโโ app_manager.py # Backend logic for breaks, settings, records
โโโ New.kv # Kivy UI definition file
โโโ Kivy.py # Kivy configuration
โโโ records.dat # User progress data (auto-generated)
โโโ settings.dat # User preferences (auto-generated)
โโโ Fonts/ # Custom font files
โ โโโ normal_font.otf
โ โโโ digital_font.ttf
โโโ Music/ # Audio notification files
โ โโโ break_time.mp3
โ โโโ break_over.mp3
โ โโโ study_revise_*.mp3
โ โโโ beep_on.wav
โโโ Extra_Files/ # UI assets (GIFs, images)
โโโ posture.gif
โโโ drinkwater.gif
โโโ walk.gif
records.dat - Stores user progress data:
- Total work hours
- Today's usage
- Task category breakdown
- Date tracking for daily resets
settings.dat - Stores user preferences:
- Theme settings (primary, accent, style)
- Audio file path
- Flow limit value
- Blink rate data
- Progress tracking configuration
- Exhaustion limit thresholds
You can modify these in the Options tab:
- Flow time usage (enable/disable)
- Exhaustion limit monitoring (enable/disable)
- Progress measurement period (Weekly/Monthly/Fortnightly/Custom)
- Progress limit (hours per period)
kivy>=2.1.0
kivymd>=1.0.0
pygame>=2.1.0
playsound>=1.3.0
beepy>=1.0.7
plyer>=2.0.0
kivy-garden>=0.1.4
Install all dependencies with:
pip install kivy kivymd pygame playsound beepy plyer kivy-gardenContributions are welcome! Here's how you can help:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- Bug fixes and improvements
- UI/UX enhancements
- Additional time management techniques
- Localization/translations
- Documentation improvements
- Testing on various Android devices
This project is currently unlicensed. Please contact the author for usage permissions.
Developer: Sumit Gupta
Email: sgsonu132@gmail.com
Project Link: https://github.com/Steosumit/SlideUpon-Android
Website: https://sites.google.com/view/screetime/slideupon
- Research-based on Flow State psychology
- Eye health guidelines from the 20-20-20 rule
- Pomodoro Technique principles
- Kivy and KivyMD framework communities
- MCI initialization error with some audio files (use MP3 or WAV format)
- File chooser is optimized for PC; mobile version uses different file picker
- Some features marked for next version (e.g., extended Pomodoro break selection)
- Cloud sync for progress data
- Statistics visualization with charts
- Social features for accountability
- Integration with calendar apps
- Customizable habit maker reminders
- Export progress reports
Made with โค๏ธ in India