https://github.com/city41/neosdconv

A command line tool to convert Neo Geo roms into the format needed for NeoSD
https://github.com/city41/neosdconv

game-development neo-geo neogeo neogeo-homebrew neosd retrogaming terraonion

Last synced: 10 days ago
JSON representation

A command line tool to convert Neo Geo roms into the format needed for NeoSD

• Host: GitHub
• URL: https://github.com/city41/neosdconv
• Owner: city41
• License: mit
• Created: 2018-12-22T03:19:46.000Z (about 6 years ago)
• Default Branch: main
• Last Pushed: 2024-07-03T12:53:47.000Z (6 months ago)
• Last Synced: 2024-12-08T01:47:21.204Z (22 days ago)
• Topics: game-development, neo-geo, neogeo, neogeo-homebrew, neosd, retrogaming, terraonion
• Language: TypeScript
• Homepage:
• Size: 108 KB
• Stars: 30
• Watchers: 4
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# neosdconv

A tool to convert homebrew Neo Geo ROMs into TerraOnion's NeoSD `.neo` format. This allows the program to run on real hardware via a NeoSD as well as on the MiSTer.

# Homebrew/dev only

This tool is only intended to be used by those doing Neo Geo related development. For commercial games please use TerraOnion's NeoBuilder. Issues, support, etc, around commercial games will not be considered.

## How to Use

You need NodeJS installed, at least Node 14. I am using Node 18.18.2.

1. `npm install -g neosdconv`

2. `neosdconv -i  -o  -n  -g  -y  -m  -#  -s `

The input directory is a directory containing your game's raw P, S, M, V and C ROMs

The output path is something like `./mygame.neo`.

For example: `neosdconv -i ./romFiles -o ./mygame.neo -n 'My Cool Game' -g BeatEmUp -y 2018 -m city41 -# 789`

## NGH and Screenshot

These are both optional, screenshot should not be used for homebrew ROMs.

You can set a ROM's NGH number with `-# ` (such as `-# 95` for Real Bout Fatal Fury) and also the screenshot with `-s `. NGH numbers can be found here: http://www.neo-geo.com/snk/master_list-ngh.htm. Screenshot numbers are proprietary to TerraOnion, and I don't know of an easy way to get them. The screenshot option was added for completeness.

If NGH or screenshot are provided and are invalid, they will default to zero and a warning will be emitted.

## Setting the Genre

the `-g` flag is used to set the genre. It must be one of the values found here: https://github.com/city41/neosdconv/blob/master/src/genres.ts

If it is an invalid value or left out entirely, the genre will default to `Other`.