NullVoid Launcher 🚀

NullVoid Launcher is a highly customizable, modern Android launcher built entirely with Jetpack Compose. It focuses on providing a clean, aesthetic experience with a wide variety of themes and widgets to suit your style.

✨ Features

• 🎨 Dynamic Themes & Customization: Minimalist aesthetics with custom font typography, glassmorphism specular highlights, customizable corner radii, and color tinting.
• 🕰️ Diverse Clock & Day Widgets: Minimal, Modern, Retro, Terminal, and Elegant Clock styles with matching Day of week indicators.
• ⚡ Hardware & System Telemetry:
  • Power / Battery Telemetry: 6 distinct styles (ELEGANT, MINIMAL, GAUGE_BAR, RING, TERMINAL, RETRO) with live charging indicators and direct battery settings access.
  • Storage Telemetry: 6 variants displaying free/used disk space with interactive storage manager triggers.
  • Network & Wi-Fi: Real-time upload/download throughput speed tracker, SSID/IP details, and data usage monitor.
  • Bluetooth Telemetry: Paired device connectivity tracking with battery level and peripheral-type indicators.
  • Quick Control Deck: 5-tile hardware quick-control deck for Flashlight, Airplane mode, Hotspot, Audio profiles, and Volume slider.
  • Weather Telemetry: Dynamic temperature, weather condition icons, and 4 design variants.
• 🎵 Music Integration: Multiple music widget styles (ELEGANT, MINIMAL, VINYL, RETRO, NEON) interacting with active Android media sessions.
• 📱 Smart App Drawer:
  • Filter by category tabs (ALL, FAVORITES, SYSTEM, GAMES, TOOLS).
  • Alphabetical fast-scroller with haptic feedback.
  • Custom icon styling (Monochrome & Outline modes).
  • Integrated math expression calculator right from the search bar.
  • Long-press contextual app management (Favorites, App Info, Uninstall, Hide).
• ⭐ Favorites Widget: Quick access to pinned applications directly from the homescreen.
• 📦 Github Integration & In-App Updater: Check your GitHub developer telemetry profile and seamlessly download and install releases directly from GitHub Releases.

🛠️ Tech Stack

• UI Framework: Jetpack Compose
• Design System: Material 3
• Programming Language: Kotlin
• Image Loading: Coil
• Minimum SDK: 29 (Android 10)
• Target SDK: 37 (Android 15)

📁 Project Structure

app/src/main/java/com/codershubinc/nullvoidlauncher/
├── data/              # Data management and repositories
├── ui/                
│   ├── drawer/        # App drawer implementation
│   ├── github/        # Github profile integration
│   ├── homescreen/    # Home screen layouts and themes
│   ├── music/         # Media service logic
│   ├── settings/      # Launcher settings
│   ├── theme/         # Compose theme definitions (Colors, Type, etc.)
│   └── widgets/       # Custom widgets (Clock, Music, Favorites, BottomBar)
└── utils/             # Helper classes and utilities

🚀 Getting Started

1. Clone the repository:

   git clone https://github.com/codershubinc/null-void-launcher.git

2. Open in Android Studio:
   • Ensure you have the latest version of Android Studio (Ladybug or later recommended).
3. Build and Run:
   • Select the app module and click Run.

🤝 Contributing

Contributions are welcome! Please check out CONTRIBUTING.md for detailed guidelines, project structure, and PR checklists.

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

📄 License

Distributed under the GNU General Public License v3.0 (GPLv3). See LICENSE for more information.

---

Built with ❤️ by CodersHubInc