╔════════════════════════════════════════════════════════════════╗
║  🌿  Minimalist Design  •  ⚡ Fluid Animations  •  💧 Serene  ║
║  🔒  Zero Trackers  •  📱 120Hz Optimized  •  🌍 Open Source  ║
╚════════════════════════════════════════════════════════════════╝

📖 Introduction • 📸 Gallery • 🤝 Contributors • 📥 Installation • 🛠️ Tech Stack

"Your digital sanctuary - where minimalism breathes, privacy is sacred, and every animation flows like water."

LM UI is not just another Android launcher. It's a Digital Sanctuary - a carefully crafted, open-source home screen replacement that strips away the noise of modern mobile interfaces and brings you back to what matters: clarity, calm, and control.

• 🌤️ Real-time Weather Integration - Open-Meteo API with inspirational quotes
• 🔋 Live Battery Monitoring - Visual feedback with charging animations
• 🎭 Gesture-Driven UI - Swipe, tap, long-press - every interaction feels natural
• 🌑 Dark Mode Optimized - AMOLED-friendly with true blacks
• 📊 Advanced Metrics - AQI, UV index, wind speed, humidity - all at a glance
• 🎯 Context-Aware - Hide apps, pin favorites, customize per your workflow

🏠 Experience the Serenity

🏡 Home Screen Clean clock, weather, battery status

📱 App Drawer Blurred backdrop, smooth transitions

⚙️ Settings Menu Granular customization options

Tap any screenshot to view full resolution

LM UI is open source and built for the community. If you're interested in contributing, check out the roadmap below or propose your own ideas.

Current Focus:

• Icon pack support (Lawnicons, Arcticons)
• Gesture customization (double-tap, swipe actions)
• Tablet optimization (landscape, large screens)

Future Plans:

• Localization (multiple languages)
• Theme engine (custom color palettes)
• Widget support
• Backup & restore
• Smart app suggestions

# Fork and clone
git clone https://github.com/YOUR_USERNAME/LM-UI.git
cd LM-UI

# Create a feature branch
git checkout -b feature/YourFeature

# Make changes and commit
git commit -m "feat: add your feature"
git push origin feature/YourFeature

# Open a Pull Request

Guidelines: Follow Kotlin conventions, test on Android 8.0+, write clear commits.

Questions? Open an issue or start a discussion.

System Requirements:

• Android 8.0 (Oreo) or higher
• ~15 MB storage space
• Location permission (for weather)

1. Download the APK from the link above
2. Enable "Install from Unknown Sources" in your device settings
3. Open the APK file and tap "Install"
4. Set as Default: Press Home button → Select "LM UI" → Tap "Always"
5. Grant Permissions: Allow Location access for weather features

# Prerequisites:
# - Android Studio Hedgehog (2023.1.1) or later
# - JDK 17 or higher
# - Android SDK 34

# Clone the repository
git clone https://github.com/aditandava/LM-UI.git
cd LM-UI

# Open in Android Studio
# File > Open > Select LM-UI folder

# Sync Gradle
# Android Studio will automatically sync dependencies

# Build debug APK
./gradlew assembleDebug

# Output location: app/build/outputs/apk/debug/app-debug.apk

# Or install directly to connected device
./gradlew installDebug

# Solution: Create local.properties file
echo "sdk.dir=/path/to/your/Android/Sdk" > local.properties

# Solution: Clean and rebuild
./gradlew clean
./gradlew build --refresh-dependencies

# Solution: Update Kotlin plugin in build.gradle
# Ensure Kotlin version matches project requirements

Built with Modern Android Technologies

Category	Technology	Purpose
💎 Language	1.9+	Primary development language - concise, safe, interoperable
🏗️ Architecture		Model-View-ViewModel pattern with Clean Architecture principles
⚡ Async		Non-blocking async operations with StateFlow for reactive UI
💾 Storage		Persistent storage for favorites, hidden apps, UI preferences
🌐 Networking	2.9+	Type-safe HTTP client for Open-Meteo weather API integration
🔄 JSON Parsing		Efficient JSON serialization/deserialization for weather data
🎨 UI Components		Modern UI components, RecyclerView with custom animations
🖼️ Visual Effects		Real-time blur effects for app drawer (Android 12+)
📱 Jetpack	ViewModel, LiveData	Lifecycle-aware components for robust state management

• Open-Meteo - Free, open-source weather API
  • Real-time temperature, humidity, wind speed
  • UV index, AQI (Air Quality Index)
  • No API key required, privacy-friendly

LM-UI/
├── app/
│   ├── src/main/
│   │   ├── java/com/yuhan/lmui/
│   │   │   ├── activities/
│   │   │   │   ├── MainActivity.kt          # Home screen, weather, battery
│   │   │   │   ├── SettingsActivity.kt      # Configuration UI
│   │   │   │   ├── SearchPanelActivity.kt   # Search interface
│   │   │   │   └── DefaultHomeActivity.kt   # Set-as-default prompt
│   │   │   ├── adapters/
│   │   │   │   ├── AppsAdapter.kt           # App drawer RecyclerView
│   │   │   │   └── FavoritesAdapter.kt      # Home screen favorites
│   │   │   ├── models/
│   │   │   │   ├── AppInfo.kt               # App metadata model
│   │   │   │   └── WeatherResponse.kt       # Weather API response
│   │   │   ├── viewmodels/
│   │   │   │   └── MainViewModel.kt         # State management
│   │   │   ├── utils/
│   │   │   │   ├── PrefsManager.kt          # Shared preferences
│   │   │   │   ├── Weather.kt               # Weather service
│   │   │   │   └── ExplodeItemAnimator.kt   # Custom animations
│   │   │   └── ...
│   │   ├── res/
│   │   │   ├── layout/                      # XML layouts
│   │   │   ├── values/                      # Colors, strings, themes
│   │   │   └── drawable/                    # Icons, backgrounds
│   │   └── AndroidManifest.xml
│   └── build.gradle
├── gradle/
├── fastlane/                                # App screenshots
└── README.md                                # You are here! 📍

╔═══════════════════════════════════════════════════════════════╗
║                         MIT License                           ║
║                                                               ║
║  Copyright (c) 2025 Bhargab & The Open Source Community      ║
║                                                               ║
║  Permission is hereby granted, free of charge, to any         ║
║  person obtaining a copy of this software to use, modify,     ║
║  and distribute it freely, with attribution.                  ║
╚═══════════════════════════════════════════════════════════════╝

This project wouldn't exist without:

• Open-Meteo - For providing free, privacy-friendly weather data
• Material Design - For design guidelines and components
• Kotlin Community - For an incredible language and ecosystem
• You - For considering contributing to this project ❤️

🌟 Show Your Support

If LM UI brings calm to your digital life, here's how you can help:

---

☕ Support Development

LM UI is free and always will be. But if it saves you time or brings tranquility to your digital life, consider supporting its continued development:

  

  

Every contribution helps maintain:

• 🔒 Zero tracking, forever free
• 🌐 Open-source development
• 🐛 Bug fixes and new features
• 📚 Documentation improvements
• 🌱 Community support

Your support keeps LM UI tracker-free, ad-free, and community-driven 💚

---

🌿 Made with Tranquility

"Every cloud has a silver lining, even if it's hidden for a while."

Crafted by Bhargab & The Open Source Community 🌲💧

┌───────────────────────────────────────────────────────────────┐
│  Package: com.yuhan.lmui  •  Min SDK: 26  •  Target SDK: 34 │
│  Architecture: MVVM  •  Language: Kotlin  •  License: MIT    │
│  Status: Active Development  •  Contributions: Open 🌱       │
└───────────────────────────────────────────────────────────────┘

⬆ Back to Top