unbun

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 17 Open GitHub ↗

Python utility for extracting Bun standalone JS bundles.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# unbun

`unbun` is a tiny Python utility that extracts the embedded JavaScript bundles
from Bun standalone executables (including Claude Desktop releases). Instead of
guessing offsets, it parses Bun's `StandaloneModuleGraph` footer and dumps the
exact files that were packaged with the binary.

## Requirements

- Python 3.9 or newer.
- [Biome](https://biomejs.dev/) CLI available in `PATH` (optional). If it is
  installed, `unbun` will run Biome over each extracted JavaScript file
  unless you pass `--no-format`.

## Installation

You can install the CLI straight from GitHub:

```sh
pip install git+https://github.com/can1357/unbun.git
```

This exposes the `unbun` command on your `PATH`. If you prefer a local copy,
clone the repo and run `pip install .`.

## Usage

```sh
unbun <binary> bundles/
```

By default the script writes formatted `.js` files into the target directory.

Useful flags:

- `--no-format` – skip the formatting step.
- `--biome-bin /custom/path/to/biome` – point at an alternate Biome
  executable.

## How it works

Recent Bun builds append a trailer (`\n---- Bun! ----\n`) plus a table of file
metadata to the executable. `unbun` locates that footer, parses the table of
`CompiledModuleGraphFile` records, and writes any JavaScript-like entries to
disk with stable, sanitised filenames.

If you only need the raw bundle bytes you can comment out the Biome step or
run the script with `--no-format`.

## License

MIT

unbun

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README