Whitehole

<!-- ---------- Header ---------- --> <div align="center"> <img src="app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp"> <h1>Whitehole</h1> <p>A feature-packed photo manager on top of Telegram.</p> <!-- ---------- Badges ---------- --> <div align="center"> <img alt="License" src="https://img.shields.io/github/license/beradeep/whitehole?color=c3e7ff&style=flat-square"> <img alt="Downloads" src="https://img.shields.io/github/downloads/beradeep/whitehole/total?color=c3e7ff&style=flat-square"> <img alt="Last commit" src="https://img.shields.io/github/last-commit/beradeep/whitehole?color=c3e7ff&style=flat-square"> <img alt="Repo size" src="https://img.shields.io/github/repo-size/beradeep/whitehole?color=c3e7ff&style=flat-square"> <img alt="Stars" src="https://img.shields.io/github/stars/beradeep/whitehole?color=c3e7ff&style=flat-square"> <br> </div> <!-- ---------- Labels ---------- --> <div align="center"> <img alt="API" src="https://img.shields.io/badge/Api%2029+-50f270?logo=android&logoColor=black&style=for-the-badge"/> <img alt="Kotlin" src="https://img.shields.io/badge/Kotlin-a503fc?logo=kotlin&logoColor=white&style=for-the-badge"/> <img alt="Jetpack Compose" src="https://img.shields.io/static/v1?style=for-the-badge&message=Jetpack+Compose&color=4285F4&logo=Jetpack+Compose&logoColor=FFFFFF&label="/> <img alt="material" src="https://custom-icon-badges.demolab.com/badge/material%20you-lightblue?style=for-the-badge&logocolor=333&logo=material-you"/> </div> </div> <!-- ---------- Description ---------- -->

[!Note] This project is now deprecated. Thanks to all who who used and/or contributed to Whitehole!

Features

• [x] Create and manage backups
• [x] Complete customizability
• [x] Automatic periodic sync
• [x] Material Design 3 (You)
• [x] Written in Jetpack Compose
• [x] Entirely Open Source

[!Important] This app requires access to a Telegram bot to manage your photos, keeping you in charge of your data and privacy. The bot and its owner are responsible for all operations(upload, download etc.) to and from Telegram and this app is just a client to interact with the bot. This app is not meant to and does not endorse spam or any other malicious activities. Please use it responsibly.

<!-- ---------- Download ---------- -->

Download

<a href="https://github.com/beradeep/whitehole/releases"><img alt="Get it on GitHub" src="https://user-images.githubusercontent.com/69304392/148696068-0cfea65d-b18f-4685-82b5-329a330b1c0d.png" height=80px /><a href="https://apt.izzysoft.de/fdroid/index/apk/com.bera.whitehole"><img alt="Get it on izzy" src="https://gitlab.com/IzzyOnDroid/repo/-/raw/master/assets/IzzyOnDroid.png" height=80px />

<!-- ---------- Usage ---------- -->

Getting Started

• Visit BotFather on telegram and create a bot; you'll get a token.
• Open Whitehole app, paste the bot token and proceed.
• Now, you'll be asked for a unique id.
• Next create a private group, and add the bot to the group.
• To get the unique id, type /start in the group.
• Copy and paste the unique id the app and proceed.
• Voilà! Your app is ready to use.

<!-- ---------- Screenshots ---------- -->

Screenshots

<div style="display: flex;"> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/1.png" width=24%> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/2.png" width=24%> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/3.png" width=24%> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/4.png" width=24%> </div> <!-- ---------- Contribution ---------- -->

Feedback and contributions

All contributions are very welcome!

• Bug reports and feature requests can be submitted here.
• If you are a developer and wish to contribute to the app, please fork the project and submit a pull request . Go through CONTRIBUTING.md before contributing.

Star History

<a href="https://star-history.com/#beradeep/whitehole&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=beradeep/whitehole&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=beradeep/whitehole&type=Date" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=beradeep/whitehole&type=Date" /> </picture> </a>

Credits

• kotlin-telegram-bot for the Telegram bot library.
• Material Icons for the icons.