A clean, efficient, and minimalist Android launcher built for focus and productivity.

• Features
• Getting Started
• Development
• Contributing
• Privacy & Permissions
• License

• Usage-aware app list with weekly and daily usage insights
• Favorite apps pinned to the top of the list
• Hidden apps support with a dedicated hidden-apps settings page
• Long-press app actions for uninstall, app info, APK sharing, timers, favorites, and hide/unhide
• Grid and list layouts with customizable icon size/style, grayscale mode, and fast scroller
• Workspaces and work profile support for separating personal and work apps

• Search apps, contacts, and web results from a single search bar
• Built-in calculator in the search box
• Quick actions for Play Store, browser, YouTube, and Google Maps
• Contact actions for call, SMS, and WhatsApp
• Voice search and voice-command shortcuts

• Focus Mode with allowed-app configuration and session countdown
• Pomodoro support for timed work sessions
• App Lock with PIN and biometric unlock support
• Daily app limits, quick session timers, and over-limit visual dimming
• Automatic return-to-home behavior when time limits are reached

• Todo widget with due times, priorities, recurring tasks, and alarms
• Calculator widget with basic, scientific, and converter modes
• Notifications widget with quick open, dismiss, reply, and media-aware cards
• Finance tracker widget with income/expense logging and transaction history
• Notes widget with editor support
• Calendar events widget with list and calendar views
• Countdown widget with manual timers and calendar-event countdowns
• Weather forecast widget with hourly and daily forecasts
• Workout widget and physical activity tracking widgets
• Media controller widget
• Year progress widget
• Battery and battery health widgets
• Device info and network stats widgets
• Compass, pressure, temperature, and noise meter widgets
• DNS / Private DNS widget with preset and custom providers
• GitHub contributions widget
• Standard Android third-party widget hosting

• Progressive-style web apps with icon fetching and settings management
• Built-in web app ad blocking support
• RSS feed page and feed settings
• Document viewer support for PDF, Office, and other common file formats
• APK sharing for installed apps

• Encrypted vault for protected files and private content
• Privacy dashboard activity
• App data disclosure screen
• Local-first settings/data backup support

• Shake to toggle torch
• Back tap support
• Flip-to-DND service
• Screen dimmer and night mode services
• Screen recording shortcut flow
• Calendar, steps, temperature, pressure, compass, and ambient noise integrations where hardware is available

• Wallpaper customization
• Widget theming and translucency controls
• Downloadable font support and typography options
• Workspace configuration and control center shortcut configuration
• Interactive feature tutorial for onboarding

• Add income and expense entries directly from the launcher
• Track monthly balance, savings, and recent transactions
• Add descriptions and review history from the widget UI
• Designed to work offline with local storage

• Import/export launcher settings and local data
• Change display mode, icon appearance, and wallpaper
• Manage app locks, hidden apps, favorites, timers, and widgets
• Configure workspaces, control center shortcuts, web apps, RSS feeds, and vault settings
• Adjust weather location, background translucency, and privacy-related options

Use voice in the search bar for fast interactions.

Permissions Required: Contacts and microphone.

Launch requires minimal permissions:

• Contacts → for contact search and quick actions
• Calendar → for calendar events and countdown integration
• Storage / Media → for notes, wallpapers, documents, vault files, and backups
• Usage Stats → for app usage tracking, daily limits, and sorting (optional)
• Notification Access → for notifications widget (optional)
• Activity Recognition → for steps and physical activity widgets (optional)
• Audio → for voice search and noise meter functionality (optional)
• Camera → for torch and related quick actions (optional)
• Biometric → for fingerprint-based app lock and vault access (optional)

All permissions are optional except for core launcher functionality. You can use the launcher with minimal permissions and enable additional features as needed.

1. Install the app
2. Grant requested permissions
3. Set "Launch" as your default launcher
4. Choose your preferred layout (Grid/List)
5. Add your favorite apps to the dock
6. Start exploring and customizing

• Android Studio (Hedgehog or later recommended)
• JDK 11 or higher
• Android SDK with API level 26+ (minimum) and API level 35 (target)
• Gradle 8.10.2 (included via wrapper)

1. Clone the repository:

   git clone https://github.com/guruswarupa/launch.git
   cd launch

2. Open the project in Android Studio

3. Sync Gradle files and wait for dependencies to download

4. Build the project:

   ./gradlew build

5. Run on an emulator or device:

   ./gradlew installDebug

For detailed development setup instructions, see DEVELOPMENT.md.

launch/
├── app/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/guruswarupa/launch/  # Main source code
│   │   │   ├── res/                          # Resources (layouts, drawables, etc.)
│   │   │   └── AndroidManifest.xml
│   │   ├── androidTest/                      # Instrumented tests
│   │   └── test/                             # Unit tests
│   └── build.gradle.kts                      # App-level build config
├── gradle/
│   └── libs.versions.toml                    # Dependency versions
└── build.gradle.kts                           # Project-level build config

• Kotlin - Primary programming language
• Android Views + RecyclerView - Primary UI foundation
• Jetpack Compose - Used where applicable alongside the view-based UI
• AndroidX - Core Android support libraries
• Material Components / Material 3 - UI components
• Hilt - Dependency injection
• Glide - Image loading
• Apache POI - Office document parsing

./gradlew assembleRelease

The APK will be generated at app/build/outputs/apk/release/app-release.apk

We welcome contributions! Please see our Contributing Guidelines for details on:

• How to report bugs
• How to suggest features
• How to submit pull requests
• Code style and standards
• Development workflow

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Commit your changes (git commit -m 'Add some amazing feature')
5. Push to the branch (git push origin feature/amazing-feature)
6. Open a Pull Request

For more details, see CONTRIBUTING.md.

This project is licensed under the MIT License with additional attribution requirements. See the LICENSE file for details.

Note: This software may not be substantially modified, rebranded, or claimed as the work of others without explicit written permission. Derivative works must maintain proper attribution and the same license terms.