This is a collection of command-line tools for viewing and editing file formats used in AliceSoft games.


First install the dependencies (corresponding Debian package in parentheses):

Then fetch the git submodules,

git submodule init
git submodule update

(Alternatively, pass --recurse-submodules when cloning this repository)

Then build the tools with meson,

mkdir build
meson build
ninja -C build


alice-tools can be built on Windows using MSYS2.

First install MSYS2, and then open the MINGW64 shell and run the following command,

pacman -S flex bison \
    mingw-w64-x86_64-gcc \
    mingw-w64-x86_64-meson \
    mingw-w64-x86_64-pkg-config \
    mingw-w64-x86_64-libpng \
    mingw-w64-x86_64-libjpeg-turbo \

To build the GUI, you must also install Qt:

pacman -S mingw-w64-x86_64-qt5

Then build the executable(s) with meson,

mkdir build
meson build
ninja -C build

The alice executable (located at build/src/alice.exe) should be standalone and portable.

The galice executable requires some extra files to be shipped with it due to Qt. Run the following commands to copy the required files for Qt,

mkdir deploy
cp build/src/galice.exe deploy/
windeployqt deploy/galice.exe

At this point, there are still some DLLs missing from the deploy directory. You can run the following command to determine the required DLLs,

ldd build/src/galice.exe | grep mingw64


From Source

If you’ve followed the above instructions to build alice-tools from source, run

ninja -C build install

to install it.


alice-tools can be installed via nix with the following command:

nix profile install git+

You must have flakes enabled (consult the nix documentation for how to enable flakes).


The provided Windows builds are portable, so no installation is required. Simply run the provided executable (alice.exe) from a command prompt.


All of the tools are accessed through the single alice executable. Running alice or any command without arguments will print the relevant usage instructions. E.g.

alice ain
alice ain dump

The currently implemented commands are:

alice acx     build     - Build a .acx file from a .csv
alice acx     dump      - Dump the contents of a .acx file to .csv
alice ain     compare   - Compare .ain files
alice ain     dump      - Dump various info fram a .ain file
alice ain     edit      - Edit a .ain file
alice asd     build     - Build a save file
alice asd     dump      - Dump a save file
alice ar      extract   - Extract an archive file
alice ar      list      - List the contents of an archive file
alice ar      pack      - Create an archive file
alice cg      convert   - Convert a CG file to another format
alice cg      thumbnail - Create a thumbnail for a CG file
alice ex      build     - Build a .ex file
alice ex      compare   - Compare .ex files
alice ex      dump      - Dump the contents of a .ex file
alice flat    build     - Build a .flat file
alice flat    extract   - Extract the contents of a .flat file
alice project build     - Build a .pje project file

Editing .ain files


Editing .ex files


Editing .acx files


Editing .flat files


Extracting archives


Building projects (.pje)


Known Limitations/Bugs

Source Code

The source code is available on github.

Reporting Bugs

You can report bugs on the issue tracker at github, contact me via email at, or find me on /haniho/.

Version History

Version 0.13.0

Version 0.12.1

Version 0.12.0

Version 0.11.1

Version 0.11.0

Version 0.10.2

Version 0.10.1

Version 0.10.0

Version 0.9.1

Version 0.9.0

Version 0.8.0

Version 0.7.0

Version 0.6.0

Version 0.5.1

Version 0.5.0

Version 0.4.0

Version 0.3.0

Version 0.2.1

Version 0.2.0

Version 0.1.1

Version 0.1.0