LibreSprite

 Animated sprite editor & pixel art tool.

Introduction

LibreSprite is a free and open source program for creating and animating your sprites.

• Real-time animation previews.
• Onion skinning.
• Multiple sprites can be edited at once.
• Ready to use palettes, or make your own.
• Sprites are composed of both layers & frames.
• Tiled drawing mode, useful to draw patterns and textures.
• Pixel precise tools like filled contour, polygon, shading mode, etc.
• Several file types supported for your sprites and animations.

Download

Grab an AppImage for Linux, or get the Windows Portable.

History

LibreSprite originated as a fork of Aseprite, developed by David Capello. Aseprite used to be distributed under the GNU General Public License version 2, but was moved to a proprietary license on August 26th, 2016.

This fork was made on the last commit covered by the GPL version 2 license, and is now developed independently of Aseprite.

Compiling

Don't worry, it isn't as hard as you might think! Just follow the instructions here.

Theming

Don't like the default look of Libresprite? Don't panic, you can download from the Libresprite resources repo.

from https://github.com/LibreSprite/LibreSprite

------------------------------------

Installation

Table of contents

• Platforms
• Get the source code
• Dependencies
  • Linux dependencies
  • Windows dependencies
  • MacOS dependencies
• Compiling
  • Linux details
  • Windows details
  • MacOS details
• Installing

Platforms

You can download installers from the website. If you want to compile LibreSprite from source, continue reading.

You should be able to compile LibreSprite on the following platforms:

• Windows 10 + VS2015 Community Edition + Windows 10 SDK
• Mac OS X 11.0 Big Sur + Xcode 7.3 + OS X 11.0 SDK
• Linux + GCC 8.5 or higher with C++14 support

To compile LibreSprite you will need:

• CMake (3.4 or greater)
• Ninja
• vcpkg (Windows and MacOS only)

Get the source code

Clone the repository and its submodules using the following command:

git clone --recursive https://github.com/LibreSprite/LibreSprite

(You can use Git for Windows to clone the repository on Windows.)

To update an existing clone, use the following commands:

cd LibreSprite
git pull
git submodule update --init --recursive

Backends

LibreSprite can be compiled with two different backends:

1. SDL2 backend (WIP)
2. Allegro backend (deprecated) (Windows and Linux only)

Dependencies

You'll need the following dependencies to compile LibreSprite:

Linux dependencies

Debian/Ubuntu:

sudo apt-get install cmake g++ libcurl4-gnutls-dev libfreetype6-dev libgif-dev libgtest-dev libjpeg-dev liblua5.4-dev libpixman-1-dev libpng-dev libsdl2-dev libsdl2-image-dev libtinyxml-dev libnode-dev ninja-build zlib1g-dev

Fedora:

sudo dnf install g++ cmake libcurl-devel freetype-devel giflib-devel gtest-devel libjpeg-devel lua-devel pixman-devel libpng-devel SDL2-devel SDL2_image-devel tinyxml-devel zlib-devel ninja-build nodejs-devel

Windows dependencies

To install the required dependencies with vcpkg, run:

vcpkg install curl freetype giflib gtest libjpeg-turbo lua libpng libwebp pixman sdl2 sdl2-image tinyxml v8 zlib --triplet x64-windows

Beware: --triplet x64-windows is only necessary for a 64 architecture build.

MacOS dependencies

On MacOS you will need Mac OS X 11.0 SDK and Xcode 7.3 (older versions might work).

Compiling

First, create the build directory with the following commands:

cd LibreSprite
mkdir build
cd build

Then following the platform-specific instructions for compiling below.

The build directory will contain the results of the compilation process. If you want to build a fresh copy of LibreSprite, remove the build directory and recompile.

Linux details

To compile LibreSprite, run the following commands:

cmake -G Ninja ..
ninja libresprite

To compile the legacy Allegro backend, run cmake with the flags -DUSE_SDL2_BACKEND=off -DUSE_ALLEG4_BACKEND=on.

The repository contains a patched version of the Allegro 4 library. If you want to use your installed version of Allegro, run cmake with the flag -DUSE_SHARED_ALLEGRO4=ON. However, this is not recommended due to issues with Allegro 4.4 (1) (2).

Windows details

If you're using a command prompt and aiming for a x64 build, be sure to use the x64 prompt or it won't find vcpkg libraries.

To compile LibreSprite, run the following commands:

cmake ^
  -DCMAKE_TOOLCHAIN_FILE=put_your_vcpkg_path_here\vcpkg\scripts\buildsystems\vcpkg.cmake ^
  -G Ninja ^
  ..

To compile the legacy Allegro backend, run cmake with the flags -DUSE_SDL2_BACKEND=off -DUSE_ALLEG4_BACKEND=on.

The repository contains a patched version of the Allegro 4 library. If you want to use your installed version of Allegro, run cmake with the flag -DUSE_SHARED_ALLEGRO4=on.

MacOS details

To compile LibreSprite, run the following commands:

cmake \
  -DCMAKE_OSX_ARCHITECTURES=x86_64 \
  -DCMAKE_OSX_DEPLOYMENT_TARGET=10.7 \
  -DCMAKE_OSX_SYSROOT=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX11.0.sdk \
  -G Ninja \
  ..
ninja libresprite

Installing

Once you've finished compiling, you can install LibreSprite by running the following command from the build directory:

ninja install 

from https://github.com/LibreSprite/LibreSprite/blob/master/INSTALL.md