Zenith is a smart digital wellbeing assistant for Android, built with Material Design 3 Expressive. It uses proactive interventions and real-time monitoring to help you break addictive scrolling habits through a fluid, motion-rich experience.

• Bedtime Mode (New): Automate your digital detox with customizable schedules, Wind Down notifications, and automatic Do Not Disturb.
• Interactive Widgets (New): Keep track of your app streaks and daily focus progress with Material 3 Expressive home screen widgets.
• Mindful Gateway: Proactively interrupt all non-whitelisted apps with a mindful pause to prevent mindless scrolling.
• Backup & Restore: Securely save your settings and schedules with automated periodic backups or manual exports.
• Shield Mode: Protect specific apps with mindful pauses and usage frequency limits.
• Goal Pursuit: Set and achieve target usage times for productive applications.
• Session HUD: A floating, customizable overlay (size & opacity) that shows remaining time for active sessions.
• Early Kick: Optional reminders or early ejection to help you transition out of apps before your limit expires.
• Expressive Design: Fully compliant with Material Design 3 Expressive guidelines, featuring fluid motion, adaptive typography (GSFlex), and floating navigation components.

1. Clone this repository.
2. Open it in Android Studio Ladybug (2024.2.1) or a newer version.
3. Ensure Android SDK 33+ is installed.
4. Build and run on a physical device (recommended for proper permission handling).

To help you stay focused and break mindless habits, Zenith needs a few permissions.

Without these, Zenith won't be able to track your usage or help you stay mindful.

1. Usage Stats (PACKAGE_USAGE_STATS): This lets Zenith see how much time you spend in your apps so it can help you stick to your limits.
2. System Overlay (SYSTEM_ALERT_WINDOW): This allows Zenith to show a "Shield" or a timer over other apps when you've reached your limit or need a mindful pause.
3. App List (QUERY_ALL_PACKAGES): Zenith needs this to show you a list of your apps so you can choose which ones you want to track or block.
4. Notifications (POST_NOTIFICATIONS): Used to send you goal reminders and keep you updated on your focus progress throughout the day.
5. Do Not Disturb (ACCESS_NOTIFICATION_POLICY): This allows Bedtime Mode to automatically silence your phone so you can get a better night's sleep.

These are optional, but they make Zenith much more reliable and powerful.

6. Accessibility Service (BIND_ACCESSIBILITY_SERVICE): An optional service that helps Zenith catch when you open a restricted app instantly, making your "Shields" feel much more responsive.
7. Notification Intercept (BIND_NOTIFICATION_LISTENER_SERVICE): This lets Zenith hide distracting notifications during your scheduled Focus sessions or Bedtime.
8. Battery Optimization: This tells Android not to close Zenith in the background, ensuring your focus time is always tracked accurately.
9. Precise Timing (SCHEDULE_EXACT_ALARM): Makes sure your daily resets, bedtime schedules, and reminders happen exactly when they're supposed to.
10. Storage Access (READ_EXTERNAL_STORAGE): Only used if you want to use the Backup & Restore feature to save or load your settings.
11. Internet Access (INTERNET): Used to check for app updates (depending on where you downloaded the app) and to let you visit our GitHub or community pages from the settings.

If you find Zenith helpful and would like to support its development, you can support me on Ko-fi. Your contribution helps keep the project alive and improving!

• Tomato - Interface and promotional material inspiration.

This project is created for learning and self-development purposes. GNU GPL v3.0