Skip to content

counter185/voidsprite

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

voidsprite logo

Free C++ pixel art editor

Preview image

◆Supported file formats

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

◆Installing

◆ You can grab a pre-built binary from the latest CI artifacts: https://nightly.link/counter185/voidsprite/workflows/msbuild/main

For Windows, get the voidsprite-build-win64.zip file.

For Linux, get the voidsprite-build-linux-flatpak-x86_64.zip file; this requires Flatpak to be installed.

◆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
    *Only x64 builds work right now, 32-bit Windows targets do not compile

Linux

  1. Install the dependencies and their respective development packages: sdl3, sdl3_ttf, sdl3_image, libpng, pugixml, zlib, liblcf, libjxl, libhwy
    • Some dependencies (libpng, pugixml, zlib, liblcf) will be automatically downloaded and built during the build step if not installed - don't worry if your distro does not package them.
    • GCC/G++ 13 or later is required
  2. Install meson (note that version 0.62.2 or higher is required; Ubuntu 22.04 users will want to install a newer version directly from pip with pip3 install --user meson)
  3. Run ./linux_build.sh
    • You can also pass the --run flag to automatically run the built binary, the --global flag to install to /usr/local, and --portable to generate a portable build (assets stored in the same directory as the executable).
    • If you installed a separate version of GCC to use alongside your system install, you can specify a different compiler by setting the CC and CXX variables while calling linux_build.sh, e.g. CC=gcc-13 CXX=g++-13 ./linux_build.sh

By default, the generated output files will be placed in /tmp/voidsprite. When --global is passed, they will be installed to /usr/local instead.

Flatpak

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

◆System requirements

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

◆Community

Official Discord server
Itch.io page
BlueSky page

◆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

Sponsor this project

Packages

No packages published

Contributors 5