|
| 1 | +# chrome-pak-customizer |
| 2 | +a simple batch tool to customize pak files in chrome or chromium-based browser |
| 3 | + |
| 4 | +## Badges |
| 5 | +[](https://ci.appveyor.com/project/myfreeer/chrome-pak-customizer) |
| 6 | +[](https://github.com/myfreeer/chrome-pak-customizer/releases) |
| 7 | +[](https://github.com/myfreeer/chrome-pak-customizer/releases/latest) |
| 8 | +[](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