TeleDrop is an Android application designed to synchronize photos and videos to a Telegram chat or channel. By utilizing Telegram Bots, the application provides a method for media backup and storage directly from an Android device to the Telegram cloud.

• Telegram Integration: Connects to specific Telegram accounts via a user-created Bot.
• Media Synchronization: Supports the upload of both photo and video formats.
• Automated Configuration: Includes a "Find Me" feature to automatically detect Chat IDs, simplifying the setup process.
• Quick Settings Integration: Provides a Quick Settings tile for immediate synchronization access from the system notification shade.
• Home Screen Widget: Allows for synchronization initiation directly from the home screen.
• Background Processing: Utilizes Android WorkManager to ensure reliable file uploads, even when the application is not in the foreground.
• Modern Interface: Built using Jetpack Compose and Material 3 design principles.

• Language: Kotlin
• UI Framework: Jetpack Compose (Material 3)
• Networking: Retrofit and OkHttp
• Concurrency: Coroutines and WorkManager
• Persistence: Room Database and DataStore
• Image Loading: Coil

• Android Device running Android 7.0 (API Level 24) or higher.
• A valid Telegram account.

1. Build or Install: obtain the APK by building from the source code or downloading a release version.
2. Bot Creation:
   • Locate @BotFather on Telegram.
   • Execute the /newbot command.
   • Follow the prompts to assign a name and a username to the bot.
   • Securely note the generated HTTP API Token.
3. Configuration:
   • Launch TeleDrop.
   • Input the Bot Token in the provided field.
   • Initiate a conversation with the created bot on Telegram by sending /start.
   • In the TeleDrop application, select "Find Me" to verify the connection and retrieve the Chat ID.
4. Permissions: Grant the requested media access permissions to enable file synchronization.

• Manual Synchronization: Launch the application and select the "Connect" or Sync option.
• Quick Settings Tile: Access the notification shade, edit the active tiles, and add the TeleDrop Sync tile. This allows for immediate synchronization without opening the main application.
• Widget: Add the Sync Widget to the home screen via the system's widget selection menu.

Building this project requires Android Studio Ladybug or a newer version.

1. Clone the repository:

   git clone https://github.com/rrrainielll/TeleDrop.git

2. Open the project directory in Android Studio.
3. Sync Gradle project files.
4. Execute the build or run command for the target emulator or device.

Contributions are permitted. Improvement suggestions or feature additions can be proposed via the issue tracker or pull requests.

1. Fork the Project
2. Create a Feature Branch
3. Commit Changes
4. Push to the Branch
5. Open a Pull Request

Distributed under the MIT License. Refer to the LICENSE file for details.