Skip to content

Commit

Permalink
Create README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
myfreeer committed Apr 15, 2018
1 parent e07f86a commit 91d2d4f
Showing 1 changed file with 61 additions and 0 deletions.
61 changes: 61 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
# chrome-pak-customizer
a simple batch tool to customize pak files in chrome or chromium-based browser

## Badges
[![Build status](https://ci.appveyor.com/api/projects/status/4ji3guqh4yyjfiaa?svg=true)](https://ci.appveyor.com/project/myfreeer/chrome-pak-customizer)
[![Download](https://img.shields.io/github/downloads/myfreeer/chrome-pak-customizer/total.svg)](https://github.com/myfreeer/chrome-pak-customizer/releases)
[![Latest Release](https://img.shields.io/github/release/myfreeer/chrome-pak-customizer.svg)](https://github.com/myfreeer/chrome-pak-customizer/releases/latest)
[![GitHub license](https://img.shields.io/github/license/myfreeer/chrome-pak-customizer.svg)](LICENSE)

## License
* Windows builds are licensed `LGPL 2.1+` **by default**, can be disabled by appending `-DLGPL=OFF` to cmake.
* Non-windows builds and builds with `-DLGPL=OFF` are licensed MIT.

## Usage (Windows Only)
1. Download `chrome-pak.7z` from [releases](https://github.com/myfreeer/chrome-pak-customizer/releases) and extract it to any folder.
2. Drag the pak file and drop it to `unpack.bat`.
3. The pak file would be extracted to subfolder of the folder of the pak file,
with the same name of the pak file with an `_unpacked` suffix.
4. (Optional) modify extracted files.
5. Drag `pak_index.ini` to `pack.bat`.
6. Repacked pak file would be in the same folder of `pak_index.ini` with a name like `pak_index_packed.pak`.

## Usage (Command line)
```
pak -u pak_file target_path
Unpack chrome pak file at pak_file to target_path.
pak -p pak_index_file target_pak_file
Pack chrome pak file using pak_index_file to target_pak_file.
pak_index_file would be found in unpacked path.
```

## Building
### Prerequires
* gcc
* cmake
* ninja

### Build script example
```bash
# Getting source
git clone https://github.com/myfreeer/chrome-pak-customizer --branch=develop --depth=1
cd chrome-pak-customizer

# Creating folder for build
mkdir -p build
cd build

# Running cmake
cmake -GNinja -DLGPL=OFF ..

# Building
ninja
```
### CMake options
* `LGPL`: Enable LGPL 2.1+ licensed custom startfiles on windows for smaller binary

## Credits
* https://www.chromium.org/
* https://github.com/shuax/ChromePAK
* https://github.com/myfreeer/win-startup-headers

0 comments on commit 91d2d4f

Please sign in to comment.