Elgato_dark/gaseous-server
1
0
Fork 0
mirror of https://github.com/gaseous-project/gaseous-server synced 2026-04-21 13:27:16 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
A game ROM manager, with a built in web based emulator using multiple sources to identify and provide metadata
352 commits 11 branches 52 tags 305 MiB
C# 55.5%
JavaScript 27.2%
Cython 7.1%
HTML 5.8%
CSS 3.6%
Other 0.7%
Find a file
Michael Green 26ee7e7119
Ignore and remove files that have unknown extensions (#509) 
Files will now only be processed if they have extensions defined on the Platform Mapping page.
2025-03-11 15:44:05 +11:00
.devcontainer Signature parser version bump (#477) 2025-01-26 19:37:48 +11:00
.github Remove unneeded codeql action (#447) 2024-10-25 00:36:05 +11:00
.vscode Integrate new Hasheous client (#354) 2024-05-18 15:05:25 +10:00
build Fix bug in docker healthcheck (#484) 2025-01-30 20:50:19 +11:00
gaseous-server Ignore and remove files that have unknown extensions (#509) 2025-03-11 15:44:05 +11:00
screenshots Update documentation 2024-02-02 23:19:39 +11:00
.gitignore Signature parser version bump (#477) 2025-01-26 19:37:48 +11:00
.gitmodules Migrate to new EJS CDN, and save state tweaks (#264) 2024-01-20 16:12:21 +11:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md (#61) 2023-08-15 16:43:42 +10:00
Directory.Build.props Added a version number display (#78) 2023-09-01 23:48:08 +10:00
docker-compose-build.yml Update documentation 2024-02-02 23:19:39 +11:00
docker-compose.yml Update documentation 2024-02-02 23:19:39 +11:00
Gaseous.sln Integrate new Hasheous client (#354) 2024-05-18 15:05:25 +10:00
LICENSE Change license from GPL to AGPL (#355) 2024-05-18 19:34:08 +10:00
logo.png Create an icon 2024-02-08 13:19:16 +11:00
README.MD Integrated EJS 4.0.11 2024-02-07 22:29:05 +11:00

README.MD

.NET CodeQL Build Release Docker Image

Gaseous Server

This is the server for the Gaseous system. It offers ROM and title management, as well as some basic in browser emulation of those ROMs.

Warning

Versions 1.6.1 and earlier are not suitable for being exposed to the internet, as:

  1. there is no authentication support, meaning anyone could trash your library
  2. the server has not been hardened for exposure to the internet - so there maybe unknown vulnerabilities

If you expose one of these earlier versions of the server to the internet, you do so at your own risk.

Version 1.7.0 and later contain user authentication, and can be exposed to the internet. However, it is recommended to no expose the server to the internet if you're not actively using it remotely, or if you have alternative means to access it remotely like a VPN.

While we do our best to stay on top of server security, if you expose the server to the internet you do so at your own risk.

Screenshots

Library Game Emulator

Requirements

  • MariaDB 11.1.2 (preferred) or MySQL Server 8+
    • These are the database versions Gaseous has been tested and developed against. Your mileage may vary with earlier versions.
    • MariaDB is the preferred database server, while MySQL will continue to be supported for existing users (they should be interchangable).
    • Note that due to the earlier database schema using MySQL specific features, moving to MariaDB from MySQL will require rebuilding your database from scratch. The "Library Scan" background task can be used to re-import all titles.
  • Internet Game Database API Key. See: https://api-docs.igdb.com/#account-creation

If using the provided docker-compose.yml, MariaDB will be installed for you.

Friends of Gaseous

Third Party Projects

The following projects are used by Gaseous

Discord Server

Join our Discord server!

Installation

See https://github.com/gaseous-project/gaseous-server/wiki/Installation for installation instructions.

Adding Content

  1. Import signatures: see https://github.com/gaseous-project/gaseous-server/wiki/Signatures
  2. Add ROMs: see https://github.com/gaseous-project/gaseous-server/wiki/Adding-ROMs