Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hack0z/luject

🍹A static injector of dynamic library for application (android, iphoneos, macOS, windows, linux)
https://github.com/hack0z/luject

android frida injection ios lua luajit reverse-engineering xmake

Last synced: 3 months ago
JSON representation

🍹A static injector of dynamic library for application (android, iphoneos, macOS, windows, linux)

Awesome Lists containing this project

README

        


luject



github-ci


Github All Releases


license




Reddit


Gitter


Telegram


QQ


Donate

A static injector of dynamic library for application


## Introduction ([中文](/README_zh.md))

luject is a static injector of dynamic library for application. It support the following applications:

* Android APK
* iPhoneOS IPA
* Windows Program (does not supported yet)
* Linux Program
* MacOS Program

If you want to know more, please refer to:

* [Documents](https://xmake.io/#/home)
* [HomePage](https://xmake.io)
* [Github](https://github.com/lanoox/luject)
* [Gitee](https://gitee.com/lanoox/luject)

## Prerequisites

XMake installed on the system. Available [here](https://github.com/xmake-io/xmake).

## Build

```console
$ xmake
```

## Installation

```console
$ xmake install
```

## Usage

```console
$ luject -i app.apk lib1.so lib2.so
$ luject -i app.ipa lib1.dylib lib2.dylib
$ luject -i liba.so lib1.so lib2.so
$ luject -i app.exe lib1.dll lib2.dll
$ luject -i a.dll lib1.dll lib2.dll
$ luject -i liba.dylib lib1.dylib lib2.dyib
$ luject -i bin lib1.so lib2.so
```

## Example

### Inject libfrida-gadget.so to apk

Use frida tools to dynamically analyze the application. For details, see: [frida](https://github.com/frida/frida)

```console
$ luject -i app.apk -p libtest /tmp/libfrida-gadget.so
```

libtest is a so library that requires matching injection in the apk, and supports pattern matching to achieve batch injection, for example: `libtest_*.so`,
if you do not specify the `-p` parameter, all so are defaulted for batch full injection.

refs: [How to use frida on a non-rooted device](https://lief.quarkslab.com/doc/latest/tutorials/09_frida_lief.html)

## Development

### Build and run

```console
$ xmake
$ xmake run luject -i [input] liba.so libb.so
```

### Build and run tests

```console
$ xmake build test
$ xmake run test
```

## Contacts

* Email:[[email protected]](mailto:[email protected])
* Homepage:[tboox.org](https://tboox.org)
* Community:[/r/tboox on reddit](https://www.reddit.com/r/tboox/)
* ChatRoom:[Char on telegram](https://t.me/tbooxorg), [Chat on gitter](https://gitter.im/tboox/tboox?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
* QQ Group: 343118190(full), 662147501
* Wechat Public: tboox-os

## Backers

Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/xmake#backer)]

## Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/xmake#sponsor)]