App List Backup

An Android application for backing up and managing your installed applications list.

📋 Overview

App List Backup is a powerful Android application that allows you to create comprehensive backups of your installed applications' metadata. Perfect for device migration, system restoration, or simply keeping track of your app ecosystem.

Key Features

• 📱 Complete App Scanning: Read all installed applications with detailed metadata
• 💾 Multiple Export Formats: JSON, Plain Text, Markdown, and HTML
• 🔍 Advanced Filtering: Filter by system/user apps, install source, and installation status
• 🔄 Comparison Tools: Compare backups with installed apps to identify missing applications
• 🏪 Store Integration: One-tap installation via Play Store, F-Droid, and other stores
• 🌍 Internationalization: English by default, Spanish translation included
• 🎨 Modern UI: Material Design 3 with dynamic colors (Android 12+)

🎯 Use Cases

• Device Migration: Easily transfer your app list when setting up a new Android device
• System Backup: Create snapshots of your installed apps before major system updates
• App Management: Keep track of which apps you have installed and from where
• Version Tracking: Monitor app versions and update history
• Documentation: Export your app list for documentation or sharing purposes

🏗️ Architecture

This project follows Clean Architecture principles with MVVM pattern:

┌─────────────────────────────────────────┐
│         Presentation Layer              │
│  (Jetpack Compose UI + ViewModels)     │
├─────────────────────────────────────────┤
│         Domain Layer                    │
│  (Use Cases + Business Logic)           │
├─────────────────────────────────────────┤
│         Data Layer                      │
│  (Room DB + PackageManager)             │
└─────────────────────────────────────────┘

Tech Stack

• Language: Kotlin
• UI: Jetpack Compose with Material Design 3
• DI: Hilt
• Database: Room
• Async: Coroutines + Flow
• Serialization: Kotlinx Serialization
• Navigation: Navigation Compose

📊 App Metadata Extracted

For each installed application, the following information is collected:

• Name: Display name of the application
• Package Name: Unique identifier
• Version: Version name and code
• Size: Approximate APK size
• Install Date: When the app was first installed
• Update Date: Last update timestamp
• Target SDK: Target Android SDK version
• Min SDK: Minimum supported SDK (estimated)
• Type: System app or user-installed
• Install Source: Play Store, F-Droid, APK, ADB, etc.

🚀 Getting Started

Prerequisites

• Android Studio: Hedgehog (2023.1.1) or later
• JDK: 17 or later
• Gradle: 8.7 or later
• Android SDK: Min 26, Target 35

Installation

1. Clone the repository:

git clone https://github.com/yourusername/AppListBackup.git
cd AppListBackup

2. Open the project in Android Studio

3. Sync Gradle dependencies

4. Build and run on your device or emulator

Building

# Debug build
./gradlew assembleDebug

# Release build
./gradlew assembleRelease

# Run tests
./gradlew test

📱 Permissions

The app requires the following permission:

• QUERY_ALL_PACKAGES: Required to see all installed applications on Android 11+

Note: This permission requires justification for Play Store submission. The app is designed for device management and backup purposes, which is an eligible use case.

📦 Export Formats

JSON

Machine-readable format, perfect for re-importing backups.

Plain Text

Human-readable format with all app details in a structured text file.

Markdown

Documentation-friendly format, great for GitHub or technical documentation.

HTML

Formatted table view, suitable for printing or web viewing.

🔄 Comparison Feature

Compare any backup with your currently installed apps to see:

• Missing Apps: Apps in the backup but not currently installed
• New Apps: Apps currently installed but not in the backup
• Same Apps: Apps present in both lists
• Version Differences: Apps with different versions between backup and current installation

🌐 Internationalization

Currently supported languages:

• 🇬🇧 English (default)
• 🇪🇸 Spanish

Additional languages can be easily added by contributing translations to strings.xml.

🛠️ Development

Project Structure

app/
├── src/main/
│   ├── java/com/applistbackup/
│   │   ├── data/              # Data layer (repositories, database)
│   │   ├── domain/            # Domain layer (models, use cases)
│   │   ├── presentation/      # UI layer (screens, viewmodels)
│   │   ├── ui/                # Theme and styling
│   │   ├── util/              # Utilities and extensions
│   │   └── di/                # Dependency injection modules
│   └── res/                   # Resources (strings, colors, etc.)

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a 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

Code Style

This project follows the official Kotlin Coding Conventions.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Material Design 3 guidelines by Google
• Jetpack Compose community
• Android developer community

📞 Support

For questions, issues, or feature requests:

• Open an issue
• Contact: [your-email@example.com]

🗺️ Roadmap

Current Version: 1.0.0

• Basic app scanning
• Backup creation and storage
• Multiple export formats
• Comparison feature
• Store integration
• Filtering and search

Future Enhancements

• APK backup support
• Cloud synchronization (Google Drive, Dropbox)
• Scheduled automatic backups
• Backup encryption
• App categories and tagging
• Backup comparison (backup vs backup)
• Dark mode preferences
• Widget support

---

Made with ❤️ using Kotlin and Jetpack Compose