Skip to content

Commit 91d2d4f

Browse files
authored
Create README.md
1 parent e07f86a commit 91d2d4f

1 file changed

Lines changed: 61 additions & 0 deletions

File tree

README.md

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
# chrome-pak-customizer
2+
a simple batch tool to customize pak files in chrome or chromium-based browser
3+
4+
## Badges
5+
[![Build status](https://ci.appveyor.com/api/projects/status/4ji3guqh4yyjfiaa?svg=true)](https://ci.appveyor.com/project/myfreeer/chrome-pak-customizer)
6+
[![Download](https://img.shields.io/github/downloads/myfreeer/chrome-pak-customizer/total.svg)](https://github.com/myfreeer/chrome-pak-customizer/releases)
7+
[![Latest Release](https://img.shields.io/github/release/myfreeer/chrome-pak-customizer.svg)](https://github.com/myfreeer/chrome-pak-customizer/releases/latest)
8+
[![GitHub license](https://img.shields.io/github/license/myfreeer/chrome-pak-customizer.svg)](LICENSE)
9+
10+
## License
11+
* Windows builds are licensed `LGPL 2.1+` **by default**, can be disabled by appending `-DLGPL=OFF` to cmake.
12+
* Non-windows builds and builds with `-DLGPL=OFF` are licensed MIT.
13+
14+
## Usage (Windows Only)
15+
1. Download `chrome-pak.7z` from [releases](https://github.com/myfreeer/chrome-pak-customizer/releases) and extract it to any folder.
16+
2. Drag the pak file and drop it to `unpack.bat`.
17+
3. The pak file would be extracted to subfolder of the folder of the pak file,
18+
with the same name of the pak file with an `_unpacked` suffix.
19+
4. (Optional) modify extracted files.
20+
5. Drag `pak_index.ini` to `pack.bat`.
21+
6. Repacked pak file would be in the same folder of `pak_index.ini` with a name like `pak_index_packed.pak`.
22+
23+
## Usage (Command line)
24+
```
25+
pak -u pak_file target_path
26+
Unpack chrome pak file at pak_file to target_path.
27+
28+
pak -p pak_index_file target_pak_file
29+
Pack chrome pak file using pak_index_file to target_pak_file.
30+
pak_index_file would be found in unpacked path.
31+
```
32+
33+
## Building
34+
### Prerequires
35+
* gcc
36+
* cmake
37+
* ninja
38+
39+
### Build script example
40+
```bash
41+
# Getting source
42+
git clone https://github.com/myfreeer/chrome-pak-customizer --branch=develop --depth=1
43+
cd chrome-pak-customizer
44+
45+
# Creating folder for build
46+
mkdir -p build
47+
cd build
48+
49+
# Running cmake
50+
cmake -GNinja -DLGPL=OFF ..
51+
52+
# Building
53+
ninja
54+
```
55+
### CMake options
56+
* `LGPL`: Enable LGPL 2.1+ licensed custom startfiles on windows for smaller binary
57+
58+
## Credits
59+
* https://www.chromium.org/
60+
* https://github.com/shuax/ChromePAK
61+
* https://github.com/myfreeer/win-startup-headers

0 commit comments

Comments
 (0)