https://github.com/warleysr/dechainer
Android application that utilizes Device Owner privileges to effectively block pornography and permanently break the chain of addiction
https://github.com/warleysr/dechainer
android blocker device dns owner porn vpn
Last synced: 22 days ago
JSON representation
Android application that utilizes Device Owner privileges to effectively block pornography and permanently break the chain of addiction
- Host: GitHub
- URL: https://github.com/warleysr/dechainer
- Owner: warleysr
- License: apache-2.0
- Created: 2026-01-01T01:09:05.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-05-31T20:13:02.000Z (about 1 month ago)
- Last Synced: 2026-05-31T22:09:38.841Z (about 1 month ago)
- Topics: android, blocker, device, dns, owner, porn, vpn
- Language: Kotlin
- Homepage:
- Size: 1.07 MB
- Stars: 3
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Déchaîner
> **Caution:** This software implements deep system-level modifications. It is designed to be difficult to bypass. Proceed only if you fully understand the implications of Device Owner privileges.
## Overview
**Déchaîner** (pronounced [/de.ʃɛ.ne/](https://en.wiktionary.org/wiki/d%C3%A9cha%C3%AEner)) is a French verb that means to unleash, unchain, or let loose. It is a specialized security utility for Android designed to function as an absolute barrier against pornography and digital addiction. By leveraging deep system-level integration, it provides a persistent defensive layer that remains effective even when willpower is compromised.
## Technical Architecture
Unlike standard application-level blockers, Déchaîner operates through **Device Owner** privileges. This administrative tier allows the application to enforce restrictions directly at the Operating System level, preventing unauthorized removal or circumvention.
### Core Capabilities
| Feature Category | Implementation Detail |
|:----------------------|:---------------------------------------------------------------------------------------------------|
| **System Integrity** | Prevents uninstallation, factory resets, safe mode booting, and ADB debugging. |
| **Network Security** | Enforces family-safe Private DNS (e.g., Cloudflare Family, AdGuard DNS) and blocks VPN subsystems. |
| **Content Filtering** | Enforces `URLBlocklist` policies on compatible browsers and auto-blocks incompatible ones. |
| **App Analysis** | Uses an Accessibility Service for keyword detection and specific Activity interception. |
| **App Management** | Block, prevent uninstall or set usage time limit for any app. |
## Installation and Configuration
The elevation to Device Owner status requires a bridge between user-space and system-space. Follow these steps precisely:
1. **Environment Setup**: Install the [Shizuku](https://shizuku.rikka.app/) application. This is required to execute the necessary ADB commands.
2. **Developer Authorization**: Enable **Wireless Debugging** in your Android Developer Options and pair it with Shizuku.
3. **Application Pairing**: Open Déchaîner and grant it permission to access the Shizuku service.
4. **Privilege Elevation**: Navigate to the Settings tab in Déchaîner and follow the prompts to register the application as the **Device Owner**. This will execute the required `dpm set-device-owner` command via the Shizuku bridge.
## Recovery and Safety Protocol
Upon configuration, Déchaîner generates a unique **16-character alphanumeric recovery key**. This key is the only method to disable restrictions or uninstall the application without a complete device wipe (if a wipe is even permitted by your active settings).
### Mandatory Safety Steps:
* **Physical Record**: You must manually write this key on a physical piece of paper.
* **Secure Storage**: Store the paper in a physical location that is difficult to access (e.g., a safe, a high shelf, or a separate building).
* **Digital Prohibition**: Do **not** save this key in digital notes, emails, or cloud storage. You may inadvertently block access to the very tools needed to retrieve it.
## Critical Security Advisory
**Déchaîner is designed to be uncompromising.**
The activation of full system restrictions combined with the loss of your Recovery Key may result in a **permanent inability** to modify system parameters or restore the device to its original state.
* **Self-Lockout Risk**: This is an intentional feature designed to stop "your future self" from relapsing.
* **No Backdoors**: There are no alternative recovery methods. If the key is lost, the lockdown is absolute.
---
**Disclaimer**: This software is provided "as is" without warranty of any kind. The developers are not liable for any data loss, system instability, or permanent device lockouts resulting from the use of Device Owner privileges.