/XFiles

A general-purpose file explorer for (rooted) Android, with support for compressed archives, remote file servers, device-to-device file transfers, checksums, etc...

Primary LanguageJavaGNU Lesser General Public License v3.0LGPL-3.0

XFiles

A general-purpose file explorer for (rooted) Android, with support for compressed archives, remote file servers, device-to-device file transfers, checksums, etc...

API Cirrus Build Status

00mainview 00mainviewgrid 001quicksearch 002xreserver 003advancedsort 004compress 005compressbrowse 006contsel 007contselgrid 008advancedsearch 009checksum 010godir

Getting Started

Two main components:

  • XFiles application (that will be built as APK)
  • Roothelper native executable (which gets cloned from here and built automatically by the Android gradle script)

Releases

Prebuilt APKs are available in the Releases section of this repo. RootHelper standalone binaries are available here as well.

Demos

Usage demos are available here.

Building

Prerequisites

  1. Windows, Linux or MacOS with git preinstalled;
  2. Android Studio 4.1+ with CMake and NDK plugins (it is recommended to install them from SDK Manager BEFORE importing the project).

Build instructions

Roothelper

  1. The build script for RootHelper is invoked automatically as inner task of the Android gradle build script, and the library binaries are put in the lib folder of the project, in order to be packed into the APK. Follow the below steps if you want to perform a manual build instead.
  2. Clone the Roothelper repository, or change dir into the automatically cloned repo from this project's root.
  3. Botan amalgamated source code files for all needed target platforms are already provided in the botanAm folder, however if you want to regenerate them after having downloaded/cloned the official source from here: just run the script genBotanAmalgamations.sh ( or genBotanAmalgamations.bat for Windows ) after having set the variables $BOTAN_SRC_DIR to the Botan source dir
  4. Point a terminal to the roothelper source base dir, then run the genRootHelpersAndroid.sh / genRootHelpersAndroid.bat script, after having set the $NDKDIR variable to the extracted path (the default should already be fine under Linux), and the $XFILES_ASSET_DIR one to the root path of the XFiles project
  5. If you want instead to build RootHelper for your desktop platform (Windows/Mac/Linux/BSD), just run genRootHelperDesktopFull.sh / genRootHelperDesktopFull.bat which starts a CMake configure+build, or genRootHelperDesktop.sh / genRootHelperDesktop.bat which rebuilds a preconfigured CMake project

XFiles

  1. Open Android Studio, and then the SDK Manager
  2. Install latest NDK and CMake
  3. Open the project (the first sync will last a few minutes, due to the native library build step)
  4. Build the project/Build APK from the IDE

Development tools used

Contributing

  • Suggestions, bugfixes, pull-requests are welcome

License

Both XFiles and RootHelper are released under the LGPL license, with unRAR clause for some files of p7zip source in RootHelper. See the LICENSE and LICENSE_UNRAR files for further details.