KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #ai #dsh-plugin #ai-agent #mcp #deepseek-harness #windows

papaw

★ 47 Open GitHub ↗

A simple, decompressing executable packer

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

```
 _ __   __ _ _ __   __ ___      __
| '_ \ / _` | '_ \ / _` \ \ /\ / /
| |_) | (_| | |_) | (_| |\ V  V /
| .__/ \__,_| .__/ \__,_| \_/\_/
|_|         |_|
```

[![Build Status](https://github.com/dimkr/papaw/actions/workflows/release.yml/badge.svg?branch=master)](https://github.com/dimkr/papaw/actions)

## Overview

papaw is a permissively-licensed packer for executables which contain statically linked, third-party components of various licenses and run on various devices, with limited disk space.

papaw reduces the size of executables and makes executables capable of replacing themselves on disk, while optionally providing very basic anti-debugging protection to discourage those attempting some trivial reverse-engineering techniques.

It is designed to be portable across different devices, therefore it avoids machine-specific assembly and the use of fexecve() or other, newer system calls which could be used to simplify it.

## Implementation

papaw consists of a small executable (~15-40K) containing a decompressor. It extracts a compressed executable appended to it by the papawify script.

The payload executable is extracted to a temporary file. When running as root, this is done by mounting a tmpfs file system and lazily unmounting it before the extraction.

## Supported Compression Algorithms and Implementations

* LZMA2, using [XZ Embedded](https://tukaani.org/xz/embedded.html) (the default)
* LZMA1, using the [LZMA SDK](https://www.7-zip.org/sdk.html) decompressor
* LZMA2, using [Minimal LZMA](https://github.com/ionescu007/minlzma)
* Zstandard, using the [zstd](https://github.com/facebook/zstd) decompressor
* Deflate, using [miniz](https://github.com/richgel999/miniz)

The first two are extremely similar in compression ratio, code size, memory usage and speed.

## Usage

papaw uses [Meson](http://mesonbuild.com/) as its build system. To pack an executable using papaw, build papaw, then use papawify to pack the executable.

papaw can be used as a Meson subproject; in that case, custom_target() is the recommended way to run papawify.

However, it is also possible to run papawify manually and pre-built, static binaries are available [here](https://github.com/dimkr/papaw/releases). For example:

```
wget https://github.com/dimkr/papaw/releases/latest/download/papawify-xz https://github.com/dimkr/papaw/releases/latest/download/papaw-xz-x86_64
python3 papawify-xz papaw-xz-x86_64 /bin/bash bash-packed
du -h /bin/bash bash-packed
./bash-packed --version
```

## Legal Information

papaw is free and unencumbered software released under the terms of the MIT license; see COPYING for the license text.

The ASCII art logo at the top was made using [FIGlet](http://www.figlet.org/).

papaw

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README