-
Notifications
You must be signed in to change notification settings - Fork 38
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
61 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 |