Skip to content

DirtBagXon/hypseus-singe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Hypseus Singe

Hypseus Singe

Hypseus is a fork of Matt Ownby's Daphne.

A program to play laserdisc arcade games on a PC, Mac or Raspberry Pi.

This version includes Singe support for Fan Made and American Laser Games.

Features:

  • SDL2 support
  • Updated MPEG2 decoder
  • Daphne VLDP 32bit upgrade
  • Integrated (active) bezel support
  • Daphne and Singe 4k 4Gb+ M2V support
  • Singe full 32bit overlay support (details below)
  • Multiple GameController (hotplug) support: config
  • Joystick, GamePad, Lightgun EV_ABS [mouse] support
  • Advanced configuration and multi-joystick support: config
  • 'lair/ace' hardware and software original scoreboards.
  • 64bit Windows and MacOS X Ports

Windows

Windows files and documentation can be found here

Compile

Minimum software requirements: gcc, cmake, autotools, zlib, SDL2, libtool, libzip, vorbis and ogg.

MacOS X

Use homebrew to install the following packages:

brew install cmake
brew install autoconf
brew install automake
brew install pkg-config
brew install sdl2
brew install sdl2_ttf
brew install sdl2_image
brew install sdl2_mixer
brew install libtool
brew install libvorbis
brew install libogg
brew install libzip

Newer series Macs may need to use the brew libmpeg2 package:

brew install libmpeg2

Then clone the libmpeg2 branch:

git clone --single-branch --branch libmpeg2 https://github.com/DirtBagXon/hypseus-singe.git

Raspberry Pi

For Raspberry Pi clone the RetroPie branch via:

git clone --single-branch --branch RetroPie https://github.com/DirtBagXon/hypseus-singe.git

Further RetroPie and Raspberry Pi information can be found here

Compilation with CMake

Build:

mkdir build
cd build
cmake ../src
make

Install and Run

Ensure you have data in the following hypseus HOME folders:

pics, fonts, ram, roms, midi, sound, singe, vldp

Run hypseus with daphne style arguments on the command line:

hypseus lair vldp -framefile vldp/lair/lair.txt -scorebezel

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

In Windows, create .bat, or .vbs, scripts with arguments for specific games.

Example .bat files are provided within the Windows zip file.

Retro gaming systems will require adoption within the relevant emulation scripts.

The singe -retropath argument can ease integration into EmulationStation style systems.
Although this is now discouraged in favor of the Zipped LUA (zlua) packages.

bash scripts are provided for systems that support this shell.

Build Hypseus home and install bash scripts:

mkdir -p ~/.hypseus/roms ~/.hypseus/vldp ~/.hypseus/singe
cp -R pics sound fonts midi ~/.hypseus

sudo cp build/hypseus /usr/local/bin/hypseus.bin
sudo cp scripts/run.sh /usr/local/bin/hypseus
sudo cp scripts/singe.sh /usr/local/bin/singe

Input Configurations

Configuration of button keycodes and joysticks should be made within hypinput.ini

By default SDL2 Keycodes and the Joystick API configuration options will be used.

Use the hypjsch utilities to help with advanced scancode configurations.

Refer to keylist.txt for SDL2 keycode values.

SDL GameController API configuration can now be enabled for supported controllers.

Enable SDL_GameController using -gamepad. Example config: hypinput_gamepad.ini

Update the Controllers db by placing gamecontrollerdb.txt in the Hypseus home folder.

Game Configuration arguments

Refer to CmdLine.md for the full argument list.

Screenshots

(Click images for YouTube playlist)

Hypseus

singe

Altering Hypseus or Singe ROM locations in bash scripts

Edit run.sh and singe.sh, to reflect the location of your ROM folders:

HYPSEUS_SHARE=~/.hypseus

Bezels

Bezel arguments are documented in: Bezels.md

Hardware USB Scoreboard

Example arguments: -usbscoreboard COM 4 9600

Full details of the USB scoreboard here.

Software Scoreboard

Enable the software external scoreboard panel in lair/ace: -scorepanel.
Use KEY_TILT to switch displays when using multiple screens.

A bezel based alternate is also available via: -scorebezel

The scorepanel, or bezel, can be positioned using -scorepanel_position x y - Window Managers may influence placement of the panel, scorebezel is not under their influence. The -scorebezel_alpha argument is a transparency option for the bezel based scoreboard.

Singe

For Singe, provide the following arguments to hypseus:

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

Check for Singe LUA game files here.

Singe 2

Hypseus Singe has support for Singe 2 games, including full 32bit overlays.

For current details see: Hypseus Singe Data

Lightguns

Singe supports Sinden and DolphinBar based lightguns with the -manymouse argument.

This argument enables absolute (EV_ABS) mouse input event codes.

Note: -sinden automatically enables -manymouse

Singe joystick [mouse] support

Singe automatically interprets joystick axis change, on joystick #0, as basic digital mouse input.

Adjust sensitivity via -js_range <1-20> in game arguments, or disable with -nojoymouse

Game Controllers

-gamepad -manymouse will enable multiple mouse inputs via multiple Game Controller analog inputs.

Support

This software is intended for educational purposes only.
Please submit issues or pull requests directly to the project.

About

Open development of Daphne, by Matt Ownby, ceased several years ago.

Singe LUA games were originally a plugin to Daphne, created by Scott Duensing.

This repository builds upon the Hypseus project initiated by Jeffrey Clark.
It marked the beginning of the transition to SDL2 for Daphne, but excluded Singe.

The name of this application, refers to a sibling of Daphne in Greek mythology.

Thanks go out to Matt Ownby, Scott Duensing, Jeffrey Clark, Manuel Alfayate, David Griffith and the many other developers who made their work available for me to build upon. Without them this project would not be possible.

License

Hypseus Singe, Being Retro Orientated This Humble Emulator Regenerates
Copyright (C) 2021-2025 DirtBagXon

Hypseus, Multiple Arcade Laserdisc Emulator
Copyright (C) 2016 Jeffrey Clark

Daphne, the First Ever Multiple Arcade Laserdisc Emulator
Copyright (C) 1999-2013 Matt Ownby

GNU General Public License version 3

This program is free software: you can redistribute it and/or modify
it under the terms of the [GNU General Public License] as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
[GNU General Public License] for more details.

Trademark

The "Hypseus Singe" mark is used to uniquely identify this project as an Arcade Laserdisc Emulator. Any direct or indirect commercial use of the mark "Hypseus" is strictly prohibited without express permission.