| Section | Description |
|---|---|
| Features | What the app can do |
| Where to Get It (Download) | Download links for the latest stable APK |
| Build from Source | Prerequisites and compilation instructions |
| Bug Reports & Feature Suggestions | How to report issues or request new features |
| Contributions | Guidelines for contributing to the repository |
| Under the Hood | Tech stack and core architecture |
| Attributions & Credits | Acknowledgments of third-party tools and creators |
| Privacy Policy | Link to the complete Privacy Policy |
| Disclaimer | Terms of service, liability, and disclosures |
| License | GNU General Public License v3.0 details |
 |
 |
 |
| Home tab | Categories Tab | Saved Wallpapers |
 |
 |
 |
| Single Upload screen | Multi upload | Wallpaper Details |
 |
 |
 |
| Manage Categories | Edit Details | Settings |
- Personal Telegram Wallpaper Cloud: Use your own Telegram channel as unlimited cloud storage for your custom wallpaper library.
- Multi-Device Sync: Seamlessly sync your favorite wallpapers, custom categories, and library across all your devices.
- Home Feed: Explore your wallpaper library with high-quality preview grids and quick action controls.
- Categories & Collections: Organize wallpapers into customizable categories for effortless browsing.
- Saved & Favorites: Keep track of your favorite wallpapers in a dedicated tab for quick access.
- Single & Multi-Upload: Upload single images or bulk upload multiple wallpapers at once directly to your Telegram channel.
- One-Tap Wallpaper Set: Apply wallpapers directly to your Home Screen, Lock Screen, or both.
- Modern & Lightweight UI: Built with Jetpack Compose and Material Design 3 featuring Monet dynamic color integration, fluid animations, and smooth screen transitions.
- Privacy Respecting: Fully self-hosted on your personal Telegram account with zero data collection or third-party tracking. For more info refer to Privacy Policy.
You can download the latest compiled APK directly from the following sources:
| GitHub | Obtainium |
|---|---|
|
|
| Orion Store | SafeHaven Store |
|
|
Builds are split per CPU architecture, so pick the one that matches your device:
| APK | Use it when |
|---|---|
TeleWalls-<version>-arm64-v8a-release.apk |
Almost every phone from the last several years |
TeleWalls-<version>-armeabi-v7a-release.apk |
Older 32-bit devices |
TeleWalls-<version>-x86_64-release.apk |
64-bit emulators and x86 Chromebooks |
TeleWalls-<version>-x86-release.apk |
32-bit x86, rare outside older emulators |
TeleWalls-<version>-universal-release.apk |
You are unsure, or sideloading somewhere unusual |
If you prefer to compile the app yourself, you can easily build it from the source code using the included Gradle wrapper.
Prerequisites:
- Git
- JDK 17 (or higher)
- Android SDK (Command Line Tools, API level 35)
- The
ANDROID_HOMEenvironment variable must be set, pointing to your SDK path. - You must have accepted the SDK licenses (e.g., running
yes | sdkmanager --licenses).
Compilation Commands:
# Clone the repository
git clone https://github.com/jaival-11/TeleWalls.git
cd TeleWalls
# Build debug APK
./gradlew assembleDebug
# Build release APKs (both ABI splits and universal APK)
./gradlew assembleReleaseEncountered a bug or have a brilliant idea to make TeleWalls even better?
- Found a bug?
Open a Bug Report using the provided template. Please include necessary and correct details so it can be squashed quickly!
- Have an idea?
Open a Feature Request using the provided template and describe how it would improve the app.
Feel free to open an Issue
You can also contact me directly via details given at the top, though GitHub Issues is preferred.
Contributions from the open-source community are always welcome!
- Fork the repository.
- Create a new branch for your feature (
git checkout -b feature/AmazingFeature). - Commit your changes (
git commit -m 'feat: add some AmazingFeature'). - Push to the branch (
git push origin feature/AmazingFeature). - Open a Pull Request!
TeleWalls is built using Kotlin and Jetpack Compose following modern Android development practices:
- Telegram Integration (TDLib): The app communicates directly with Telegram servers using TDLib (Telegram Database Library). Wallpapers are stored as documents in your private Telegram channel, serving as unlimited cloud storage.
- Jetpack Compose & Material 3: Declarative UI built with Jetpack Compose featuring Material Design 3, Monet dynamic color scheme integration, and smooth micro-animations.
- Hilt Dependency Injection: Hilt manages dependencies across ViewModels, Repositories, and UI components to maintain a clean MVVM architecture.
- Local Persistence & Caching: Room DB and DataStore Preferences handle local metadata indexing, wallpaper categorization, and offline preference caching.
- Image Management & Palette Extraction: Coil handles async image loading and caching, while AndroidX Palette extracts adaptive accent colors from wallpaper thumbnails.
- Background Operations: WorkManager schedules and executes background upload and sync tasks reliably.
This project stands on the shoulders of giants. A massive thank you to the developers, projects, and communities that make TeleWalls possible:
- TDLib (Telegram Database Library): The official, cross-platform Telegram library by Telegram. It powers the secure communication with Telegram servers for cloud wallpaper storage.
- Jetpack Compose & Kotlin: By JetBrains and Google. Provides the modern declarative UI framework, coroutines, and reactive state management.
- Creamie: Used for UI design, layout structure, and theming inspiration.
- TeleDrive: Used as reference for TDLib integration and backend storage architecture.
- Material Design Icons: By Google. Provides the iconography across the app UI.
- Coil: Image loading library for Android powered by Kotlin Coroutines.
- Lottie Compose: By Airbnb. Powers vector-based UI animations.
- AboutLibraries: By Mike Penz. Powers the in-app open-source credits and license viewer.
Read complete Privacy Policy at Privacy Policy.
The Privacy Policy was last updated on 9th Sept, 2026.
TeleWalls is an independent, open-source project. It is not affiliated with, endorsed by, or in any way officially connected to Telegram Messenger Inc. All product and company names are trademarks™ or registered® trademarks of their respective holders. Use of them does not imply any affiliation with or endorsement by them.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.
This application acts as a neutral, local wallpaper management tool. By utilizing TeleWalls, you acknowledge that you are solely responsible for ensuring your use of the software complies with the Terms of Service of any third-party platforms accessed (including Telegram). The developer assumes no liability for any account restrictions or ToS violations incurred by the user.
This project— including the codebase, documentation was developed with the assistance of AI.
TeleWalls is licensed under the GNU General Public License v3.0.
Copyright © 2026 Jaival
Made with ❤️ by Jaival
