Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

OpenHSP/Hot Soup Processor(HSP3)

OpenHSP/Hot Soup Processor (HSP3) is a scripting language system that anyone can easily use. You can easily build applications such as game programs, screen savers, tools and practical software using images just by writing a text script. HSP3 can run the development environment on Microsoft Windows, Linux / Raspberry Pi . For detailed installation and usage, refer to the manual for each platform.

HSP3 Linux / Raspberry Pi version manual

HSP3 Windows Manual

OpenHSP/Hot Soup Processor (HSP3)は、誰でも手軽に使うことのできるスクリプト言語システムです。 テキストによるスクリプトを書くだけで、簡単に画像を使ったゲームプログラム、スクリーンセーバー、ツールや実用ソフトなどのアプリケーションを構築することができます。

Windows installation

You can download the original Windows version from the official HSP3 page. You can choose between the installer (.exe) or the archive (.zip).

The latest beta test version can be downloaded from this link.

Linux installation

It works in the Linux GUI environment (X Window System). Some features work using OpenGL and SDL libraries. If you can connect to the network, get the repository directly with the git command.

git clone

If you have an archive, extract the contents to any directory and compile the source. To compile, you need an environment where you can run gcc and make. The following libraries are required when compiling, so please check in advance.

OpenGL ES2.0 or later / EGL SDL1.2 gtk+-2

For Debian (Ubuntu), you can install the library from the package manager as follows.

sudo apt update
sudo apt install libgtk2.0-dev
sudo apt install libglew-dev
sudo apt install libsdl1.2-dev libsdl-image1.2-dev libsdl-mixer1.2-dev libsdl-ttf2.0-dev
sudo apt install libgles2-mesa-dev libegl1-mesa-dev

The repository contains only the source, so you need to compile it with make. (If it doesn't compile correctly depending on your Linux version or distribution, you'll need to fix it.)

cd OpenHSP

The necessary tools have been compiled and HSP3 is ready for use.

Raspberry Pi installation

It runs on Raspberry Pi, Raspberry Pi2, Raspberry Pi3, Raspberry Pi4, Raspberry Pi zeo. It runs on Raspbian (RaspberryPi OS). (Recommended version is September 2017 Kernel version 4.9 or later) Please use it with Raspbian running and a keyboard and mouse connected in advance. hsp3dish, hsp3gp (HGIMG4) and hsed (script editor) only work in GUI environment. Extract the latest version from github to any directory and compile the source. To compile, you need an environment where you can run gcc and make.

git clone
cd OpenHSP

Additional libraries are required when compiling. Setup is executed by executing the following command while connected to the network.


The archive contains only the sources and must be compiled by make. (If it doesn't compile correctly depending on the version or distribution of Raspbian, you need to fix it.)

make -f makefile.raspbian

Execute the make command in the directory where the contents of the archive are expanded. The necessary tools have been compiled and HSP3 is ready for use.

  • For Raspberry Pi 4, please install with make in the same way as Linux.
  • Raspberry Pi 4 does not support full-screen execution


After installation, the following command will be generated.

hsed script editor (simplified version)
hspcmp HSP3 code compiler
hsp3cl HSP3 command line runtime
hsp3dish HSP3Dish runtime
hsp3gp HGIMG4 runtime

Script Editor (Simplified Version) is a GUI application that allows you to write and execute HSP3 scripts. It has basic script editing and load / save functions. You can start it with the following command.


You can run the script you are editing by pressing the [F5] key or selecting "Run" from the "HSP" menu. The current version uses hsp3dish as the standard runtime. The sample code corresponding to HSP3Dish is included in the sample folder, so please try it. The character code of the script is treated as UTF-8. Please note that it is different from the character code (SJIS) used by Windows.

For example, a simple script like this can be saved as "test.hsp" to check its behavior. This will display the text "Hello World".

#include ""
mes "Hello World."

If you want to know about the commands in the script, move the cursor to a word in the script editor ( for example "mes" ) and then press [F1]. Help about the instruction will be displayed. The sample folder contains samples to test various functions; try scripting with GUI, sprites, and 3D.

If you want to execute the script from the command line, you need to create an HSP object file with hspcmp.

./hspcmp -d -i -u test.hsp

In the above example, the object file "" is generated from the "test.hsp" file. Pass the generated object file to the runtime for execution.


In the above example, "" is run at the HSP3 command line runtime. Similarly, you can execute scripts tailored to the runtime such as "hsp3dish" and "hsp3gp". (A GUI environment is required to execute "hsp3dish" and "hsp3gp".)

The Raspberry Pi version runs in full screen. To interrupt the execution, press [ctrl] + [C] or [esc]. Please note that you may not be able to interrupt if the keyboard is not recognized correctly. In addition to the GUI editor, it is also possible to execute in the form of "./hsp3dish ****. Ax" from the command line.

Copyright and license

HSP3 for Linux / Raspberry Pi is treated as a derivative of OpenHSP, and the license is also a modified BSD license compliant with OpenHSP / HSP3.

Hot Soup Processor (HSP) Copyright (C) 1997-2021, Onion Software/onitama, all rights reserved. Made with base technology of OpenHSP.

OpenHSP Copyright (C) 1997-2021, Onion Software/onitama, all rights reserved.

These softwares are provided by the copyright holders and contributors "as is" and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed.