{"id":24168493,"url":"https://github.com/dirtbagxon/hypseus-singe","last_synced_at":"2025-04-05T05:05:12.342Z","repository":{"id":45765762,"uuid":"347142936","full_name":"DirtBagXon/hypseus-singe","owner":"DirtBagXon","description":"Hypseus is a SDL2 version of Daphne and Singe. Laserdisc game emulation.","archived":false,"fork":false,"pushed_at":"2025-01-10T13:08:12.000Z","size":46482,"stargazers_count":158,"open_issues_count":3,"forks_count":20,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-04-05T05:05:01.973Z","etag":null,"topics":["32bit","64bit","arcade-games","daphne","emulator","game","hypseus","laserdisc","linux","lua","macosx","raspberry-pi","retro","retropie","sdl2","sinden","singe","singe2","windows"],"latest_commit_sha":null,"homepage":"https://ko-fi.com/dirtbagxon","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DirtBagXon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-03-12T17:20:11.000Z","updated_at":"2025-03-29T21:24:31.000Z","dependencies_parsed_at":"2024-05-04T19:22:22.679Z","dependency_job_id":"ad1ce463-4ce8-4ba3-95c2-675911f73691","html_url":"https://github.com/DirtBagXon/hypseus-singe","commit_stats":null,"previous_names":[],"tags_count":59,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DirtBagXon%2Fhypseus-singe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DirtBagXon%2Fhypseus-singe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DirtBagXon%2Fhypseus-singe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DirtBagXon%2Fhypseus-singe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DirtBagXon","download_url":"https://codeload.github.com/DirtBagXon/hypseus-singe/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247289426,"owners_count":20914464,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["32bit","64bit","arcade-games","daphne","emulator","game","hypseus","laserdisc","linux","lua","macosx","raspberry-pi","retro","retropie","sdl2","sinden","singe","singe2","windows"],"created_at":"2025-01-12T22:14:56.544Z","updated_at":"2025-04-05T05:05:12.310Z","avatar_url":"https://github.com/DirtBagXon.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Hypseus Singe](screenshots/hypseus-logo.png)\n\n# Hypseus Singe\n\nHypseus is a fork of [Matt Ownby's][CUS] [Daphne].\n\nA program to play laserdisc arcade games on a PC, Mac or Raspberry Pi.\n\nThis version includes **Singe** support for Fan Made and [American Laser Games][ALG].\n\nFeatures:\n\n* SDL2 support\n* Updated MPEG2 decoder\n* Daphne VLDP 32bit upgrade\n* Integrated _(active)_ [bezel](screenshots/bezel.png?raw=true) support\n* Daphne and Singe 4k 4Gb+ M2V support\n* Singe libretro emulation path integration\n* Singe Joystick, Lightgun _EV_ABS_ [mouse] support\n* Singe 2 full 32bit overlay support (details below)\n* Sinden support in Singe games\n* For Singe games list see [here](https://github.com/DirtBagXon/hypseus_singe_data).\n* Daphne alternate overlay choices\n* Multiple *GameController* (*hotplug*) support: [config](doc/hypinput_gamepad.ini)\n* Advanced configuration and multi-joystick support: [config](doc/hypinput.ini)\n* 'lair/ace' [hardware](https://github.com/DirtBagXon/hypseus_scoreboard) and [software](screenshots/scoreboard.png?raw=true) original scoreboards.\n* 64bit Windows and MacOS X Ports\n* Coded exclusively in [vim](https://www.vim.org) using a Sun Microsystems [Type 5c keyboard](https://github.com/DirtBagXon/sunkbd).\n\n## Windows\n\n**Windows** files and documentation can be found [here](win32/)\n\n## Compile\n\nMinimum software requirements: [gcc], [cmake], [autotools], [zlib], [SDL2],\n[libtool], [libzip], [vorbis] and [ogg].\n\n### MacOS X\n\nUse homebrew to install the following packages:\n\n    brew install cmake\n    brew install autoconf\n    brew install automake\n    brew install pkg-config\n    brew install sdl2\n    brew install sdl2_ttf\n    brew install sdl2_image\n    brew install sdl2_mixer\n    brew install libtool\n    brew install libvorbis\n    brew install libogg\n    brew install libzip\n\nNewer series Macs may need to use the _brew_ `libmpeg2` package:\n\n    brew install libmpeg2\n\nThen clone the `libmpeg2` branch:\n\n    git clone --single-branch --branch libmpeg2 https://github.com/DirtBagXon/hypseus-singe.git\n\n### Raspberry Pi\n\nFor **Raspberry Pi** clone the ``RetroPie`` branch via:\n\n    git clone --single-branch --branch RetroPie https://github.com/DirtBagXon/hypseus-singe.git\n\nFurther **RetroPie** and **Raspberry Pi** information can be found [here](doc/RETROPIE.md)\n\n### Compilation with CMake\n\nBuild:\n\n    mkdir build\n    cd build\n    cmake ../src\n    make\n\n## Install and Run\n\nEnsure you have data in the following `daphne` HOME folders:\n\n    pics, fonts, ram, roms, midi, sound, singe, (vldp and vldp_dl)\n\nRun `hypseus` with `daphne` [arguments](doc/CmdLine.md) on the command line:\n\n    hypseus lair vldp -framefile vldp_dl/lair/lair.txt -scorebezel\n\n    hypseus singe vldp -framefile singe/timegal/timegal.txt -script singe/timegal/timegal.singe\n\n\nIn **Windows** you are able to create `.bat` files with arguments for specific games.\n\nExample `.bat` files  are provided within the [Windows](win32/) zip file.\n\n**Retro gaming** systems will require adoption within the relevant emulation scripts.\n\nThe singe `-retropath` argument can ease integration into libretro style systems. See [RetroPie](doc/RETROPIE.md#extended-argument-summary) as an example.\n\n`bash` scripts are provided for systems that support this shell.\n\n**Build Hypseus home and install bash scripts:**\n\n    mkdir -p ~/.daphne/roms ~/.daphne/ram ~/.daphne/vldp\n    mkdir -p ~/.daphne/vldp_dl ~/.daphne/singe\n    cp doc/hypinput.ini doc/flightkey.ini ~/.daphne\n    cp doc/hypinput_gamepad.ini ~/.daphne\n    cp -R pics sound fonts midi ~/.daphne\n    \n    sudo cp build/hypseus /usr/local/bin/hypseus.bin\n    sudo cp scripts/run.sh /usr/local/bin/hypseus\n    sudo cp scripts/singe.sh /usr/local/bin/singe\n    hypseus\n    singe\n\n## Configuration\n\nSee [CmdLine](doc/CmdLine.md)\n\nConfiguration of keycodes and joysticks should be made within [hypinput.ini](doc/hypinput.ini)\n\nBy default SDL2 Keycodes and the Joystick API configuration options will be used.\n\nSDL GameController API configuration can now be enabled for supported controllers.\n\nEnable **SDL_GameController** using `-gamepad`. Example config: [hypinput.ini](doc/hypinput_gamepad.ini)\n\nUpdate the Controllers _db_ by placing `gamecontrollerdb.txt` in the Hypseus home folder.\n\nUse the [hypjsch](https://github.com/DirtBagXon/hypjsch) utilities to help with advanced scancode configurations.\n\nRefer to [keylist.txt](doc/keylist.txt) for **SDL2** keycode values.\n\n## Screenshots\n\n*(Click images for YouTube playlist)*\n\n[![Hypseus](https://raw.githubusercontent.com/DirtBagXon/hypseus-singe/master/screenshots/screenshot.png)](https://www.youtube.com/@DirtBagXon/videos)\n\n[![singe](https://raw.githubusercontent.com/DirtBagXon/hypseus-singe/master/screenshots/singe2.png)](https://www.youtube.com/@DirtBagXon/videos)\n\n\n\n## Altering Hypseus or Singe ROM locations in bash scripts\n\nEdit **run.sh** and **singe.sh**, to reflect the location of your ROM folders:\n\n    HYPSEUS_SHARE=~/.daphne\n\n**Note:** The default Hypseus home directory, *created* when run without ``-homedir``:\n\n    ~/.hypseus\n\n## Bezels\n\nBezel arguments are documented in: [Bezels.md](doc/Bezels.md)\n\n## Hardware USB Scoreboard\n\nExample arguments: `-usbscoreboard COM 4 19200`\n\nFull details of the USB scoreboard [here](https://github.com/DirtBagXon/hypseus_scoreboard).\n\n## Software Scoreboard\n\nEnable the software external [scoreboard panel](screenshots/scoreboard.png?raw=true) in lair/ace: `-scorepanel`.  \nUse `KEY_TILT` to switch displays when using multiple screens.\n\nA *bezel* based alternate is also available via: `-scorebezel`\n\nThe 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.\n\n## Singe\n\nFor Singe, provide the following arguments to *hypseus*:\n\n    hypseus singe vldp -framefile ~/.daphne/singe/timegal/timegal.txt -script ~/.daphne/singe/timegal/timegal.singe -homedir ~/.daphne/ -datadir ~/.daphne/\n\nCheck for Singe anomalies and replacement files [here](https://github.com/DirtBagXon/hypseus_singe_data).\n\n## Singe 2\n\nHypseus Singe has support for Singe 2 games, including full 32bit overlays.\n\nFor current details see: [Hypseus Singe Data](https://github.com/DirtBagXon/hypseus_singe_data)\n\n## Lightguns\n\nSinge supports Sinden and DolphinBar based lightguns with the `-manymouse` argument.\n\nThis argument enables *absolute* (``EV_ABS``) mouse input event codes.\n\n**Note:** `-sinden` automatically enables `-manymouse`\n\n## Singe joystick [mouse] support\n\nSinge now automatically interprets **joystick axis** change as mouse movement (*Gun Games*).\n\nAdjust sensitivity via `-js_range \u003c1-20\u003e` in Singe arguments, or disable with `-nojoymouse`\n\nConfigure **joystick controls** in [hypinput.ini](doc/hypinput.ini) or via [GameController](doc/hypinput_gamepad.ini)\n\n## Extended arguments and keys\n\nHighlighted additional, and reimplemented, arguments that have been added to Hypseus Singe:\n\nRefer to [CmdLine.md](doc/CmdLine.md) for a full argument list.\n\n    -bezel \u003clair.png\u003e          [ Specify a png bezel in 'bezels' sub-folder    ]\n    -blank_blue                [ VLDP blank using YUV#1DEB6B                   ]\n    -blank_searches            [ VLDP blanking [adjust: -min_seek_delay]       ]\n    -blank_skips               [ VLDP blanking [adjust: -min_seek_delay]       ]\n    -force_aspect_ratio        [ Force 4:3 aspect ratio                        ]\n    -gamepad                   [ Enable SDL_GameController configuration       ]\n    -grabmouse                 [ Capture mouse in SDL window                   ]\n    -ignore_aspect_ratio       [ Ignore MPEG aspect ratio header [01B3]        ]\n    -keymapfile \u003cflight.ini\u003e   [ Specify an alternate hypinput.ini file        ]\n    -linear_scale              [ Enable linear filtering when scaling          ]\n    -novsync                   [ Disable VSYNC presentation on Renderer [crt]  ]\n    -original_overlay          [ Enable daphne style overlays (lair,ace,lair2) ]\n    -scalefactor \u003c25-100\u003e      [ Scale video display area [25-100]%            ]\n    -scanlines                 [ Simulate scanlines [adjust: -scanline_shunt]  ]\n    -scanline_alpha \u003c1-255\u003e    [ Adjust scanline alpha blending                ]\n    -scanline_shunt \u003c2-10\u003e     [ Shunt scanline spacing [adjust: -x -y]        ]\n    -scorebezel                [ Bezel layer software scoreboard               ]\n    -scorepanel                [ Enable software scoreboard in lair/ace/tq     ]\n    -scorepanel_position \u003cx y\u003e [ Adjust position of software_scorepanel        ]\n    -shiftx \u003c-100 to 100\u003e      [ Shift x-axis on video window [%]              ]\n    -shifty \u003c-100 to 100\u003e      [ Shift y-axis on video window [%]              ]\n    -tiphat                    [ Invert joystick SDL_HAT_UP and SDL_HAT_DOWN   ]\n    -usbscoreboard \u003cargs\u003e      [ Enable USB serial support for scoreboard:     ]\n                               [ Arguments: (i)mplementation, (p)ort, (b)aud   ]\n    -vertical_screen           [ Reorient calculations in logical fullscreen   ]\n    -vertical_stretch \u003c1-24\u003e   [ YUV vertical stretching. Useful in cliff/gtg  ]\n\n    -8bit_overlay              [ Restore original 8bit Singe overlays          ]\n    -blend_sprites             [ Restore BLENDMODE outline on Singe sprites    ]\n    -bootsilent                [ Mute sound during initVLDP() - if possible    ]\n    -js_range \u003c1-20\u003e           [ Adjust Singe joystick sensitivity: [def:5]    ]\n    -manymouse                 [ Enable ABS mouse input [lightguns] [gungames] ]\n    -nocrosshair               [ Request game does not display crosshairs      ]\n    -retropath                 [ Singe data path rewrites [.daphne]            ]\n    -sinden \u003c1-10\u003e \u003ccolor\u003e     [ Enable software border for lightguns          ]\n                               [ Color: (w)hite, (r)ed, (g)reen, (b)lue or (x) ]\n\n    Alt-Enter                  [ Toggle fullscreen                             ]\n    Alt-Backspace              [ Toggle scanlines                              ]\n    [KEY_BUTTON3]              [ Toggle scoreboard display in lair/ace         ]\n    [KEY_COIN1]=|[KEY_START1]  [ Joystick hotkey combination for [KEY_QUIT]    ]\n    [KEY_TILT]                 [ Switch scorepanel display screen lair/ace/tq  ]\n\n\nEnforce SDL Window context when Renderer auto-detection fails (_no further extensions enabled_):\n\n    -opengl                    [ Enable OpenGL SDL Window context              ]\n    -vulkan                    [ Enable Vulkan SDL Window instance             ]\n\n\nSwitch `SDL_TEXTUREACCESS` \u003csup\u003e*\u003c/sup\u003e\n\n    -texturestream             [ Enable SDL_TEXTUREACCESS_STREAMING            ]\n    -texturetarget             [ Enable SDL_TEXTUREACCESS_TARGET (Default)     ]\n\n\u003csup\u003e* _This can aid SBC's with SDL2 =\u003e_ 2.0.16\u003c/sup\u003e\n\n## Support\n\nThis software intended for educational purposes only. Please submit [issues] or\n[pull requests] directly to the [project].\n\n**DO NOT submit issues or request support from the official Daphne forums!**\n\n## About\n\nOpen development by the original author, [Matt Ownby][CUS], ceased years ago.\n\nSinge was created by [Scott Duensing][SD] as a plugin to Daphne to allow the\nplaying of [American Laser Games][ALG].\n\nThis repository was created to expand the ``Hypseus`` project started\nby [Jeffrey Clark][JAC]. Many overlays were unimplemented in the original\nrepository. Singe had also been removed.\n\nThe name of this application was changed to _Hypseus_ (_[sibling to Daphne][peneus]_)\nso the original authors of [Daphne] would not be burdened with requests for support.\n\nA massive thanks goes out to [Matt Ownby][CUS], [Scott Duensing][SD], [Jeffrey Clark][JAC],\n[Manuel Alfayate][MAC], [David Griffith][DG] and the many other developers\nwho made their work available for me to build upon. Without them this\nproject would not be possible.\n\n## License\n\n**Hypseus Singe**, Being Retro Orientated This Humble Emulator Regenerates  \nCopyright (C) 2021-2025  [DirtBagXon][owner]\n\n**Hypseus**, Multiple Arcade Laserdisc Emulator  \nCopyright (C) 2016  [Jeffrey Clark][JAC]\n\n**Daphne**, the First Ever Multiple Arcade Laserdisc Emulator  \nCopyright (C) 1999-2013  [Matt Ownby][CUS]\n\n[![GNU General Public License version 3](http://www.gnu.org/graphics/gplv3-127x51.png)][GNU General Public License]\n\n    This program is free software: you can redistribute it and/or modify\n    it under the terms of the [GNU General Public License] as published by\n    the Free Software Foundation, either version 3 of the License, or\n    (at your option) any later version.\n    \n    This program is distributed in the hope that it will be useful,\n    but WITHOUT ANY WARRANTY; without even the implied warranty of\n    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n    [GNU General Public License] for more details.\n\n## Trademark\n\nThe \"Hypseus Singe\" mark is used to uniquely identify this project as an Arcade\nLaserdisc Emulator.  __Any direct or indirect commercial use of the mark\n\"Hypseus\" is strictly prohibited without express permission.__\n\n[owner]: https://github.com/DirtBagXon\n[project]: https://github.com/DirtBagXon/hypseus-singe\n[issues]: https://github.com/DirtBagXon/hypseus-singe/issues\n[pull requests]: https://github.com/DirtBagXon/hypseus-singe/pulls\n[Daphne]: http://www.daphne-emu.com\n[CUS]: http://www.daphne-emu.com/site3/statement.php\n[gcc]: https://gcc.gnu.org/\n[zlib]: http://www.zlib.net/\n[libzip]: https://libzip.org/\n[libzippp]: https://github.com/ctabin/libzippp\n[libmpeg2]: http://libmpeg2.sourceforge.net/\n[SDL2]: https://www.libsdl.org/download-2.0.php\n[SDL2_image]: https://www.libsdl.org/projects/SDL_image/\n[SDL2_mixer]: https://www.libsdl.org/projects/SDL_mixer/\n[SDL2_ttf]: https://www.libsdl.org/projects/SDL_ttf/\n[SDL2_gfx]: https://sourceforge.net/projects/sdl2gfx/\n[ManyMouse]: https://github.com/icculus/manymouse\n[serialib]: https://github.com/imabot2/serialib\n[plog]: https://github.com/SergiusTheBest/plog\n[GLEW]: http://glew.sourceforge.net/\n[ogg]: https://en.wikipedia.org/wiki/Ogg\n[vorbis]: https://en.wikipedia.org/wiki/Vorbis\n[cmake]: https://cmake.org\n[lua]: https://lua.org/\n[lua_cjson]: https://github.com/mpx/lua-cjson\n[lua_md5]: https://github.com/lunarmodules/md5\n[lua_sha2]: https://code.google.com/archive/p/sha2/\n[luars232]: https://github.com/ynezz/librs232\n[lua_bitop]: https://bitop.luajit.org/index.html\n[luafilesystem]: https://lunarmodules.github.io/luafilesystem/\n[autotools]: https://en.wikipedia.org/wiki/GNU_Build_System\n[libtool]: https://www.gnu.org/software/libtool/manual/libtool.html\n[peneus]: https://en.wikipedia.org/wiki/Peneus\n[GNU General Public License]: http://www.gnu.org/licenses/gpl-3.0.en.html\n[JAC]: https://github.com/h0tw1r3\n[MAC]: https://github.com/vanfanel\n[ALG]: https://en.wikipedia.org/wiki/American_Laser_Games\n[SD]: https://github.com/sduensin\n[DG]: https://github.com/DavidGriffith\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdirtbagxon%2Fhypseus-singe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdirtbagxon%2Fhypseus-singe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdirtbagxon%2Fhypseus-singe/lists"}