Free C++ pixel art editor

◆Supported file formats

◆ The list of supported file formats has been moved to the web manual.

◆System requirements

◆ The system requirements table has been moved to the web manual.

◆Installing

◆ The downloads section has been moved to the web manual.

◆Links

◆ Official Discord server
◆ Itch.io page
◆ BlueSky page
◆ Web manual

◆Building

Windows

1. Run the setup_windows_devlibs.bat script
2. Open freesprite.sln with Visual Studio and build/run like any other C++ program.

You may also use MSBuild to build through commandline:

msbuild /m /t:voidsprite /p:Configuration=Release /p:Platform="x64" voidsprite.sln

Linux

CMake

1. Install CMake and dependencies required for building SDL: https://wiki.libsdl.org/SDL3/README-linux
2. Run the following commands in the root of the repository:

mkdir build
cd build
cmake ..
make -j4

The executable will be built to /build/cmake.
It's recommended to use Clang 18 for building. GCC older than 14 may not work.

Flatpak

You can also build the program as a Flatpak, see Flatpak README.

Android

1. Run the setup_android.bat script on Windows, or the setup_android_on_linux.sh script on other systems.
2. Open the android-project directory with Android Studio and build it like any other project.

Optional dependencies

Some dependencies can be disabled with build flags:

• -DVOIDSPRITE_JXL_ENABLED=0 will disable JPEG XL support (drops libjxl, libhwy requirement). JPEG XL might still be importable through SDL_image.
• -DVSP_NETWORKING=0 will disable all socket-based network features, like network canvas (drops sdl3_net requirement). HTTP features like update checks and downloading from Lospec are separate and will still work.
• -DUSE_FMT_FORMAT=1 will use fmt for string formatting instead of std::format. fmt needs to be present.
• -DVSP_USE_LIBLCF=0 will disable RPG Maker map preview and LMU tileset import (drops liblcf requirement). Import/export of XYZ images is not affected.
• -DVSP_USE_LIBAVIF=0 will disable AVIF support (drops libavif requirement). AVIF might still be importable and exportable through SDL_image.

◆Contribute

voidsprite is open for community contributions. Here are some ways you can help:

• Open PRs to contribute to the code
• Open Issues (or report them on Discord) to help get bugs and other problems fixed
• Share your custom Patterns and Templates
• Translate voidsprite into your language. More details

◆Donate

◆ You can support the project by donating on itch.io

◆Licenses

◆ voidsprite is licensed under GPLv2.
◆ Licenses for other libraries and fonts used in voidsprite can be found in the OPEN_SOURCE_LICENSES directory
◆ All content created with voidsprite (including content created using default templates, filters, patterns, etc.) remains the property of the user who created it.