Skip to content

guruswarupa/launch

Repository files navigation

Launch

A clean, efficient, and minimalist Android launcher that prioritizes simplicity and functionality.

Get it on F-Droid

Or download the latest APK from the Releases Section.


๐Ÿ“‹ Table of Contents


โœจ Features

๐Ÿ” Smart App Management

  • Apps are sorted by usage frequency automatically
  • Rarely used apps grouped and sorted alphabetically
  • App usage stats shown beside each app icon
  • Weekly phone usage summary at the bottom
  • One-tap uninstall with long-press gesture
  • Toggle between smooth grid and list views

๐Ÿ”Ž Smart Universal Search

  • Search apps, contacts, and perform web queries
  • Built-in calculator directly in search bar
  • Quick links to Play Store, browser, YouTube, and Google Maps
  • Tap-to-call, SMS, or WhatsApp directly from contact results

โšก Quick Actions

  • Time Widget โ†’ Tap to open the Clock app
  • Date Widget โ†’ Tap to open the Calendar app
  • Search Bar:
    • Long press โ†’ Open Google in browser
    • Double tap โ†’ Change wallpaper
    • Calculator support built-in
  • Weather Widget:
    • Shows real-time weather and forecast
    • Change API key via Settings
  • Battery Widget:
    • Real-time battery percentage display
    • Charging status indicator
    • Always visible on home screen

๐Ÿ”• Focus Mode

  • Long press focus icon to configure apps allowed during Focus Mode
  • Temporarily hide distracting apps
  • Set a countdown timer to auto-disable mode
  • Cannot exit until timer ends โ€” stay on track
  • Visible timer countdown displayed on screen

๐Ÿ” App Lock

  • Lock any app via settings
  • PIN-based authentication before launching locked apps
  • Fingerprint unlock supported (if available on your device)
  • 1-minute timeout after unlocking โ€” no need to re-enter PIN during that window
  • After timeout, locked apps require authentication again
  • Ideal for securing sensitive apps like WhatsApp, Instagram, etc.

๐Ÿ”‹ Power Saver Mode

  • Keeps wallpaper black to save battery
  • Hides app usage stats and weather updates
  • Ideal for low-power or OLED displays

โœ… Todo List Widget (Now Smarter)

  • Add and manage daily tasks directly from the home screen
  • Set due time for each task
  • Assign priority: High, Medium, or Low
  • Enable recurring tasks: Daily, Weekly, or Custom
  • Mark tasks as complete with visual strikethrough
  • Tap "Add Todo" to schedule tasks with advanced options
  • Persistent task tracking with clean UI

๐Ÿ”” Notifications Widget

  • View unread notification count badge
  • Quick access to recent notifications on home screen
  • Swipe to dismiss notifications directly from launcher
  • Tap notifications to open the related app
  • Requires notification access permission

๐Ÿงฎ Calculator Widget

  • Full-featured calculator directly on home screen
  • Basic Mode: Standard arithmetic operations
  • Scientific Mode: Advanced functions (sin, cos, log, etc.)
  • Converter Mode: Unit conversions and base conversions
  • Calculation history with easy access
  • Toggle between radians and degrees

โฑ๏ธ App Timer Manager

  • Set usage timers for individual apps
  • Quick presets: 1 minute, 5 minutes, 10 minutes
  • Custom timer duration support
  • Automatic app closure when timer expires
  • Helps manage screen time and app usage

๐Ÿ“ฑ App Categories & Organization

  • Organize apps by type (Social, Productivity, Games, etc.)
  • Filter apps by category
  • Smart grouping of rarely used apps

โญ Favorite Apps & Show All Mode

  • Mark apps as favorites for quick access
  • Toggle between "Favorites Only" and "Show All Apps" modes
  • Customize which apps appear in main list
  • Quick access to your most-used apps

๐Ÿ“ฆ APK Sharing

  • Share APK files of installed apps
  • Access from app context menu or dock
  • Share via any installed app (Bluetooth, email, messaging, etc.)
  • Useful for backing up apps or sharing with others

๐ŸŽจ Third-Party Widget Support

  • Add Android widgets from other apps
  • Full widget management system
  • Configure and customize widgets on home screen
  • Support for all standard Android widgets

๐ŸŽฏ Onboarding Experience

  • First-run setup wizard
  • Guided introduction to key features
  • Permission requests with explanations
  • Quick start guide for new users

๐Ÿ’ฐ Finance Tracker

  • Tap "Add Income" or "Add Expense" to track your finances
  • Monthly income and expenses tracked automatically
  • Long press on Balance to view recent transaction history
  • Add custom descriptions to your transactions
  • Net savings computed for the current month
  • Lightweight, offline-first design

โš™๏ธ Settings Features

  • Import/Export Data: Backup or restore your launcher settings and data
  • Reset App Usage Stats: Start fresh any time
  • Change Display Style: Toggle between grid and list view easily
  • Update Weather API Key: Use your personal API key from openweathermap.org
  • Manage App Locks: Configure PIN and fingerprint authentication
  • App Timer Settings: Configure default timer durations
  • Widget Management: Add, remove, and configure widgets
  • Workspace Configuration: Customize workspace layouts

๐Ÿค Gestures Guide

Gesture Result
Tap Time Widget Opens Clock app
Tap Date Widget Opens Calendar app
Long Press Search Bar Opens Google in browser
Double Tap Search Bar Opens wallpaper picker
Long Press App Icon Opens uninstall prompt
Long Press Dock App Remove or rename app
Type in Search Bar Instant calculator
Long Press Focus Icon Enter Focus Mode setup
Long Press Balance View transaction history
Swipe Notification Dismiss notification from widget

๐ŸŽ™๏ธ Voice Commands

Use voice in the search bar for fast interactions.

Command Example Action
Call Swaroop Starts a phone call
Message Swaroop Opens SMS app
WhatsApp Swaroop Opens WhatsApp chat
Send hi to Swaroop Sends WhatsApp message
Search weather tomorrow Google search
Open YouTube Launches YouTube
Uninstall WhatsApp Opens uninstall screen
Bangalore to Mysore Opens Google Maps with route

Permissions Required: Contacts, Phone, SMS


๐Ÿ” Privacy & Permissions

Launch requires minimal permissions:

  • Contacts โ†’ for contact search and quick actions
  • SMS โ†’ to send messages
  • Phone โ†’ to make calls
  • Storage โ†’ for notes, wallpapers, and backups
  • Usage Stats โ†’ for app usage tracking and sorting (optional)
  • Notification Access โ†’ for notifications widget (optional)
  • Location โ†’ for weather widget location-based forecasts (optional)
  • Audio โ†’ for voice search functionality (optional)

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


๐Ÿš€ Getting Started

  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

๐Ÿ› ๏ธ Development

Prerequisites

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

Setup

  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.

Project Structure

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

Key Technologies

  • Kotlin - Primary programming language
  • Jetpack Compose - Modern UI toolkit
  • AndroidX - Android support libraries
  • Room - Local database
  • Material Design 3 - UI components

Building for Release

./gradlew assembleRelease

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


๐Ÿค Contributing

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

Quick Start for Contributors

  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.


๐Ÿ“„ License

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

Note: This software may not be sold, rebranded, or used for commercial purposes without explicit permission.

About

No description, website, or topics provided.

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages