Repository files navigation

Hypseus Singe game demos onYoutube

If you have older game content, ensure you update the existing lua and other data with files from
this repository. Backup your existing data, then overwrite the metadata with repository files.
You only require the video and audio files from your existing version (see below).

These games are updated frequently, ensure files are up-to-date.

Feel free to submit pull requests for any fixes or improvements.

To grab specific folders from this repo, this GitHub tool is highly recommended:

https://download-directory.github.io/

Paste the relevant repofolder URL into the tool, it will allow you to download just thatfolder content, as a zip.

From version2.11.2, Hypseus Singe supports zipped LUA(zlua) ROMS.
From version2.11.3, Hypseus Singe supports multi-game zipped ROMS with-usealt

Note: You do not need to unzip the ROM for usage inhypseus from version 2.11.2.
A zipped ROM can be loaded, without decompressing, direct to the Singe-script or new-zlua argument.

A number of ROMS, with the zip container, will be released to a new folder in the repohere . These can be used to replace all.singe, .ttf, .wav, .png and other files within a Singe game folder. The only files required in addition to the.zip are the.txt(framefile) andvideo/audio,m2v/ogg files. So game installations can follow somewhat similar to Daphne game folder structures. Zipped games are no longer required to be within thesinge/ subfolder. The required Singe path folder structure is held within the zip, not on disk.

A typical argument set using zip ROMS may begin:

hypseus singe vldp -zlua roms/timegal.zip -framefile vldp/timegal/timegal.txt ...

Newsbc games will utilize theMinimal overlay switching within the00-singe2/Framework. Some games have been left within thesbc categories as they do not utilize theFramework and remain to allow running on the lower spec hardware. The00-singe2-ports-gungames being the most obvious. These games should still update LUA from the repo to ensure overlays are aligned correctly moving forward.

Categorization of currently ported games which were created to run on lower
powered single-board computer devices, such as theRaspberry Pi andRK3328, used
minimalist overlays. These will now be part of the00-singe2-ports-sbc folder.
Note: This format is now deprecated in favor of the newMinimal Overlay within the00-singe2
games folder.

A subsection of the above ports weregun games, used by communities such as Sinden Gun
owners. These also use minimalist overlays, but continue to simulate the 8bit 'American Laser
Games' (ALG) games, from which they derive, using upscaled (AI enhanced) video. These will
be now within00-singe2-ports-gungames. However, many of these games are now deprecated
in favor ofzip rom versions.

The00-singe1 folder will contain original Daphne era Singe games that have received updates and bugfixes..

The00-singe2 folder contains games using the new engine with higher resolution assets and full overlays.

00-non-qte contains any game formats that move away from the Dragon's LairQTE format.

00-kimmy contains games that were created using the newer, extended feature:FrameworkKimmy.
Note: EarlierFramework games can be easily ported to use the new framework via the Singe header files.

00-zip-roms are detailed above.

Download the latest complete repository viaReleases (zip ortgz).

This repo does not contain Copyrighted © material, purely fan made graphics, sounds and LUA scripts.

Data in this repository has been created from severalFan Made sources, including Singe, Singe 2 and original
creations specifically for Hypseus.

You should notneed to alter any of the peripheral data in these subdirectories. However, these
are customizable games. If you make improvements, please consider contributing back to the repository.

If you are porting Singe 2 games, theonly required step is to obtain the video files from Singe 2
for your required game and perform a video conversion as detailedbelow usingffmpeg. This can
be performed on any PC including Windows:https://ffmpeg.org/download.html

Once you have the new.m2v and.ogg video and audio files:

• Check the duration and frame numbers matchFRAMEINFO.md (see below).
• Move them into the relevant subdirectory from this repository.
• Install the subdirectory into your Hypseus Singe ROM folder location.
• Play the game.

The files in this repository should be installed alongside the required game video (m2v) and audio (ogg) files.

Refer to the game framefile (txt) for video file layout structure.

This repository does not contain any game video or audio files. You are required to acquire these files from other sources,archive.org may help.

Download the latest complete repository viaReleases (zip ortgz).

For Singe 2 video/audio recoding follow the instructions below:

Singe 2 game files in this repository are based around various releases of Singe 2 games.
CheckFRAMEINFO.md for the required video size for each game.

Always checkFRAMEINFO.md.

Frame information frommediainfo will be provided for the Singe 2 video files in a file calledFRAMEINFO.md in each folder:

mediainfo --Inform='Video;%FrameCount%' <file>mediainfo --Inform='Video;%Duration%' <file>

mediainfo can usually be installed in Linux via packaging, e.g.:

sudo apt-get install mediainfo

In Windows:https://mediaarea.net/en/MediaInfo/Download/Windows

View  -> TreeDebug -> Advanced Mode

Look for 'Duration' and 'Frame Count'

This should allow you to know the correct video files required.

Some games use the very last frames of the source MP4 within the game LUA,i.e. have nolaserdisc stylelead-out time. TheVLDP can sometimes have issues accessing these final frames. The last frame of video can be duplicated, usingffmpeg filters, to create alead-out time and avoidVLDP issues. This can be achieved with theffmpegvideofilter:-vf tpad=stop_mode=clone:stop_duration=2

It is therefore advisable to add alead-out period by default.
Note: This will extend the total number of frames seen inmediainfo.

ffmpeg -i <original>.mp4 -an -qscale:v 4 -b:v 6000k -vf tpad=stop_mode=clone:stop_duration=2 -codec:v mpeg2video <game>.m2v

Singe 2 has an audio bug and audio is purposefully delayed in the original MP4, check with VLC. Use-ss to delay encode start to compensate:

ffmpeg -i <original>.mp4 -ss 00:00:00.330 -vn -c:a libvorbis -ar 44100 -map a -b:a 160k <game>.ogg

e.g.

ffmpeg -i FaI.mp4 -an -qscale:v 4 -b:v 6000k -vf tpad=stop_mode=clone:stop_duration=2 -codec:v mpeg2video fireandice.m2vffmpeg -i FaI.mp4 -ss 00:00:00.330 -vn -c:a libvorbis -ar 44100 -map a -b:a 160k fireandice.ogg

If your device is struggling with the HD content,this is likely on a RPi, you can resize HD in one of these operations:

ffmpeg -i FaI.mp4 -an -qscale:v 4 -b:v 6000k -vf tpad=stop_mode=clone:stop_duration=2,scale=1280:720 -codec:v mpeg2video fireandice.m2v

If sound is out of sync, use-ss to delay audio encode start inms(hh:mm:ss.SSS) on the orignal MP4:

ffmpeg -i DL2E.mp4 -ss 00:00:00.330 -vn -c:a libvorbis -ar 44100 -map a -b:a 160k dl2e.ogg

You canfix any existing.ogg files with delay easily, using:

mv dl2e.ogg dl2e_delayed.oggffmpeg -i dl2e_delayed.ogg -ss 00:00:00.330 -c copy dl2e.ogg