# Unchained for Android: a Real-Debrid client for the phone

> Unchained is a Kotlin Android app that talks to the Real Debrid API so you can add magnets, torrent links and hosted file links on the phone, then stream or download them. It ships on the Play Store, on F-Droid and as GitHub release builds, and the search plugins live in a separate repository.

**LivingWithHippos/unchained-android** — App to interact with real-debrid API

- Repository: https://github.com/LivingWithHippos/unchained-android
- Stars: 648 · Forks: 71
- Language: Kotlin
- License: GPL-3.0
- Published: 2026-10-21 · Updated: 2026-10-21 · Language: en
- Canonical page: https://hysenlabs.com/projects/livingwithhippos-unchained-android

## The app is a front end to a paid download service, not a downloader of its own

Unchained is described as an app to interact with the Real Debrid API, and the README spends a section explaining what Real Debrid is, because the app makes no sense without it.

Real Debrid is described as a service to download files from hosting websites and the torrent network. Files are downloaded directly on their servers, and you then use those files for your own downloads. The stated benefit is high speeds for a lot of services like Mega and RapidGator without needing all their premium accounts, and it can also stream media files directly.

There is a bold note attached to that: Real Debrid is a cheap paid service.

So the division of labour is clear. Real Debrid does the downloading, on its own infrastructure, at its own speed, and hands back a link that behaves like a direct file URL. Unchained is the Android client that adds such links, tracks them, and plays them.

That has a consequence for how you should read the feature list. The support for magnets and torrents, for file hosting services, for containers and for streaming is support for the corresponding Real Debrid API operations, not for local downloading machinery inside the app.

The audience is therefore an existing Real Debrid subscriber on Android. The README also links the author's referral link for Real Debrid premium alongside the donation options, which is the usual arrangement for a client app in this category: the app is free, and the service behind it is the paid part.

## Streaming means a player on the device, not playback in the app

The feature list is a checklist, and one entry on it is a requirement rather than a capability: streaming support needs a player that supports streaming, like mpv or VLC.

So the app is not a media player. It resolves a Real Debrid link into something playable and hands it to whatever is on the device that can play it. That is worth knowing before you install it, because the app is useful in a different way than a torrent client with a built in player would be: it is a link manager and a launcher for content that is already cached on the service's servers.

The rest of the list is more conventional. Magnets and torrents support, and file hosting services support, both of which are the two ways a Real Debrid link is normally created. Containers support, which refers to Real Debrid folders rather than local containers. User info, which surfaces the account state. And themes, which is the light and dark interface.

The search feature is the one with its own history. You can search websites for files with plugins, and the README notes that the plugins have been moved to another repository, with a link to a GitLab project under the same account.

So the search function is now a plugin host that loads definitions from elsewhere. The plugin format is described as needing some knowledge of HTML and regular expressions, with a wiki page for the search engine described as work in progress, and the author hoping there will be more documentation including a video in the future. A plugin is essentially a description of how to scrape a site and turn the results into links the app can offer.

That is a meaningful boundary. The app handles the service, and searching the open web is a separate, community-maintained layer that may or may not be in sync with the app version you have installed.

## Four install routes, and the nightly build is the interesting one

The installation section lists four options, and the spread is what you would expect from a project that has been around long enough to accumulate distribution channels.

The first is the latest published release from GitHub. The second is the zipped APK from the latest build, possibly unstable, taken from a nightly.link endpoint that resolves the master branch, or extracted from the GitHub Actions summary of the latest working workflow, which requires being logged in to GitHub. The third is the Play Store, and the fourth is F-Droid, and the badges also show an IzzyOnDroid repository.

The nightly route deserves a note, because it is the one that tells you something about the project. A nightly build is the master branch compiled on every push, and it is explicitly flagged as possibly unstable. It exists because the author wants contributors and users to be able to test the current state without waiting for a release, and because the Actions workflow output is the easiest way to get a build of a specific commit.

So the practical choice is between the store version, which is the stable one and the one most users should take, and the nightly, which is for testing a specific change.

The build status badge points at a workflow named build.yaml on the master branch, and the release tags show a pattern of small increments: v1.8.0 and a hotfix v1.8.1, both in August and September 2026, following v1.7.1 earlier in the year. The primary language is Kotlin, the licence is GPL-3.0, and the last push was on 2026-09-02.

## The architecture is a conventional modern Android stack, and the dev branch is where work happens

The development section describes a standard Android project with a few specifics that matter for contributors.

Contributions are welcome, and the discussion tab is the place to ask for help setting up the project. The stated requirement is at least Android Studio 2021.1.1 to build, and the branch model is explicit: the dev branch is where development happens, and it gets merged into master when a release is ready. There is also a debug version available which reports crash information automatically, described as useful for helping the author debug errors.

The architecture is listed as MVVM, with Dagger-Hilt for dependency injection, Data Binding for managing user interface and data relations, and Navigation. The networking and storage layers are Retrofit with OkHttp, Moshi for serialisation, and Room for the database. Coroutines and Flow handle the asynchronous work, Livedata is there too, and Coil loads images.

Two details are worth pulling out. The application id is com.github.livingwithhippos.unchained, which is why the F-Droid and Play Store links use that path. And the localisation situation is a little unusual: the app is available in English, Italian, Spanish and French, and the external translation service that contributors used to add a language is noted as currently down, with the fallback being to fork the project and add the strings to the strings.xml file in the values-xx folders.

The repository also holds fastlane/ for the store metadata, which is where the screenshot set in the README comes from, and a PLUGINS.md at the root that is the pointer to the plugin documentation.

## Where Unchained is the wrong tool

The first wrong-tool case is a user without a Real Debrid subscription. The app is a client for somebody else's service, and the service is the paid, working part. Without an account, most of the app has nothing to talk to.

The second case is someone who wants to search the web for downloadable content through the app and expects it to work out of the box. The search plugins were moved to a separate repository, and the plugin format is described as needing some knowledge of HTML and regular expressions with the wiki still a work in progress. If search is a primary reason you would install this, the plugin repository is the thing to evaluate first, because it is the part that is outside the app's own release cycle.

The third case is a team that wants a maintained client with a support commitment. This is a single-maintainer project with a Discord, a Ko-Fi link, an issue tracker and no release notes beyond the tag names. The licence is GPL-3.0, which is the right choice for this kind of app and gives you the right to fork it, but forking an Android app is a heavier commitment than forking a library.

There is a fourth, more mundane limitation that applies to any app in this category: the API it depends on is somebody else's, and the app is a thin layer over it. If Real Debrid changes its API, the app has to follow, and there is a lag.

What the project does provide is a clean way to use an existing subscription from a phone, with the interface and the file handling done for you, and with the option to run a build of master that contains whatever was fixed last.

## Conclusion

Unchained suits an Android user who already pays for Real Debrid and wants to add and play downloads from the phone rather than from a desktop interface, and the Play Store and F-Droid builds mean you do not have to build anything. It does not suit someone without a Real Debrid subscription, since the service is a paid one and the app is a front end to it, and it does not suit a team that wants the search plugin behaviour to be part of the app repository, because the plugins were moved to a separate GitLab project. Before adopting, read PLUGINS.md, check the plugin repository separately, and note that the last push was on 2026-09-02, so the Play Store build and the master branch may not be in step.

## FAQ

### What does the Unchained for Android app do?

It interacts with the Real Debrid API so you can add magnets, torrents and hosted file links from your phone, then stream or download them. The app also supports containers, user info, themes, and searching websites for files through plugins.

### Do I need a Real Debrid subscription to use Unchained?

Yes. Real Debrid is described as a cheap paid service that downloads files on its own servers, and Unchained is a client for that API. The README also states that streaming support needs a separate player on the device that supports streaming, such as mpv or VLC.

### How do I install Unchained for Android?

There are four routes: the latest published release from GitHub, the zipped APK from the nightly build of the master branch or from the GitHub Actions workflow summary, the Play Store listing, and F-Droid. The nightly build is flagged as possibly unstable.

### Where are the search plugins for Unchained maintained?

The plugins have been moved to a separate repository on GitLab, and the plugin format needs knowledge of HTML and regular expressions, with a wiki page for the search engine described as work in progress. The app's own PLUGINS.md file is the pointer to that documentation.

### What license is Unchained for Android released under?

The project is licensed under GPL-3.0, with the LICENSE file at the root of the repository. The app is written in Kotlin using MVVM, and the current release tag is v1.8.1 with the last push on 2026-09-02.

## Sources

- [Issues](https://github.com/LivingWithHippos/unchained-android/issues)
- [License: GPL-3.0](https://github.com/LivingWithHippos/unchained-android/blob/master/LICENSE)
- [LivingWithHippos/unchained-android on GitHub](https://github.com/LivingWithHippos/unchained-android)
- [README](https://github.com/LivingWithHippos/unchained-android/blob/master/README.md)
- [Releases](https://github.com/LivingWithHippos/unchained-android/releases)

---

Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/livingwithhippos-unchained-android