Skip to content

Instantly share code, notes, and snippets.

@whinee
Last active September 15, 2025 23:15
Show Gist options
  • Select an option

  • Save whinee/fb8e84190e87819c38999415094e26e8 to your computer and use it in GitHub Desktop.

Select an option

Save whinee/fb8e84190e87819c38999415094e26e8 to your computer and use it in GitHub Desktop.
How to Compile Aseprite (Pixel Art) for Linux (and if I'm not lazy, for Windows)

How to Compile Aseprite (Pixel Art) for Linux...

...and if I'm not lazy, for Windows

Aseprite, according to Wikipedia, is a proprietary, source-available image editor designed primarily for pixel art drawing and animation.

If there is enough demand, I might make a guide for Windows as well.

Linux Instruction

  1. Copy the following text then paste it in a text editor:
sudo dnf install -y @development-tools gcc gcc-c++ git cmake ninja-build xcb-util

cd /tmp
git clone --recursive https://github.com/aseprite/aseprite
cd aseprite
bash build.sh --auto
rm -rf ~/.local/bin/aseprite
mkdir -p $HOME/.local/share/aseprite
cp -r build/bin/* $HOME/.local/share/aseprite/
rm -rf $HOME/.local/bin/aseprite
ln -s $HOME/.local/share/aseprite/aseprite $HOME/.local/bin/aseprite
cd ..
rm -rf aseprite

mkdir -p $HOME/.local/share/applications/
tee $HOME/.local/share/applications/aseprite.desktop > /dev/null <<EOF
[Desktop Entry]
Type=Application
Encoding=UTF-8
Name=Aseprite
GenericName=Sprite Editor
Comment=Animated sprite editor & pixel art tool
Categories=Graphics;2DGraphics;RasterGraphics;
Icon=/home/[USERNAME]/.local/share/aseprite/data/icons/ase64.png
Exec=/home/[USERNAME]/.local/share/aseprite/aseprite %U
TryExec=/home/[USERNAME]/.local/share/aseprite/aseprite
Terminal=false
StartupNotify=false
StartupWMClass=allegro
MimeType=image/bmp;image/gif;image/jpeg;image/png;image/x-pcx;image/x-tga;image/vnd.microsoft.icon;video/x-flic;image/webp;image/x-aseprite;
EOF
  1. Substitute instances of [USERNAME] with your Linux username.

  2. Run the resulting command in your favorite terminal.

  3. Execute using your Linux distro's built-in desktop app launcher, dmenu, rofi, etc.

Thanks for coming to my TED talk :3

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment