Skip to content

Latest commit

 

History

History
53 lines (37 loc) · 3.04 KB

README.md

File metadata and controls

53 lines (37 loc) · 3.04 KB

XFiles

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

Getting Started

Two main components:

  • XFiles application (that will be built as APK)
  • Roothelper native executable (embedded as binaries in the libs folder)

Releases

Prebuilt APKs are available in the Releases section of this repo. RootHelper standalone binaries will be available soon.

Demos

Usage demos are available here.

Building from source

Prerequisites

  1. [Optional] Botan 2.9.0
  2. Python 2.7 (already included in any recent Linux distro)
  3. Android Studio 3.0+

Build has been tested on Linux Mint 19 and Manjaro (x64)

Build instructions

Roothelper

  1. Clone the Roothelper repository
  2. [Optional] 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 the official source: just run the script genBotanAmalgamations.sh after having set the variables $BOTAN_SRC_DIR to the extracted Botan source dir
  3. Point a terminal to the roothelper source base dir, then run the genRootHelpersAndroid.sh 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
  4. If you want to build RootHelper for your desktop platform (Windows/Mac/Linux/BSD), just run genRootHelperDesktopFull.sh which starts a CMake configure+build, or genRootHelperDesktop.sh which rebuilds a preconfigured CMake project

XFiles

  1. Open Android Studio, then open the XFiles project (open, not import)
  2. If you plan to build Roothelper from source, ensure to install also latest NDK; install also CMake from the SDK Manager
  3. 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.