How to Make .neo Files Using city41's neosdconv Utility

[Neo Alec]

I was just posting this for someone else, and thought it might be helpful to people, especially in the homebrew community. There are readme instructions already included with the utility of course, but it doesn't hurt to have another explanation. Thank you for @city41 for the useful utility!

Download the neosdconv utility:

GitHub - city41/neosdconv: A command line tool to convert Neo Geo roms into the format needed for NeoSD

A command line tool to convert Neo Geo roms into the format needed for NeoSD - city41/neosdconv

github.com

(Click "Code" and choose "Download Zip")

You will also need Node installed: https://nodejs.org/en/download/

You can install neosdconv from a command line with

npm install -g neosdconv

After installing the utility and node, put your set of MAME style rom files in a new folder. Now here's the trick:
The file names need to have the .rom extension with the file type after the dash in the name. So they can't be .bin or .v1, etc. Example:
name-c1.rom
name-c2.rom (etc)
name-m1.rom
name-p1.rom
name-s1.rom
name-v1.rom

Run the Windows command line as an Administrator. Here's an example command:
neosdconv -i horekid -o horekid.neo -n "Booby Kids" -g Action -y 1987 -m Nichibutsu
"horekid" is the name of my directory with the roms in it.
(enclose any names with spaces in double quotes)
The genre must be one of the ones on this list:

neosdconv/src/genres.ts at main · city41/neosdconv

A command line tool to convert Neo Geo roms into the format needed for NeoSD - city41/neosdconv

github.com

If you get your file names wrong, the utility will output a useless .neo file. It's usually pretty easy to tell it failed this way because the resulting file will be obviously too small compared to most others.

 

[city41]

Hmm, you shouldn't have to have a .rom extension, the tool is pretty flexible on finding the files. I convert roms that have .bin, .v1, extensions all the time.

If anyone hits an issue where a rom doesn't seem to convert correctly let me know and I'll see about fixing it.

Also when specifying the genre, you have to capitalize it. "Action" will work, "action" will not. If you get the genre wrong, it will default to "Other", so not a huge deal.

 

[city41]

Alec, are you sure you didn't install neosdconv with npm at some point? From what I can tell, just downloading the zip shouldn't work.

You can install neosdconv from a command line with

npm install -g neosdconv

You will need Node installed: https://nodejs.org/en/download/

If a newer version gets released, the above will also update to the latest version.

 

[Neo Alec]

Hmm, you shouldn't have to have a .rom extension, the tool is pretty flexible on finding the files. I convert roms that have .bin, .v1, extensions all the time.

If anyone hits an issue where a rom doesn't seem to convert correctly let me know and I'll see about fixing it.

Also when specifying the genre, you have to capitalize it. "Action" will work, "action" will not. If you get the genre wrong, it will default to "Other", so not a huge deal.

Okay, that's what worked for me. Something else must have been wrong. Maybe just having the -v1 etc in the file name is the key? If I find something that doesn't work I'll post it. Thanks.

Alec, are you sure you didn't install neosdconv with npm at some point? From what I can tell, just downloading the zip shouldn't work.

You can install neosdconv from a command line with

npm install -g neosdconv

You will need Node installed: https://nodejs.org/en/download/

If a newer version gets released, the above will also update to the latest version.

This is the part I was forgetting. Will update the post. Thanks.

 

[city41]

Nice. One last tweak, you don't need to download the zip. The "npm install" command will download the tool for you.

Maybe just having the -v1 etc in the file name is the key? If I find something that doesn't work I'll post it. Thanks.

Awesome, that would be helpful. Looking at the code, neosdconv should work with names like

202-v1.rom
202-v1.bin
202-v1.v1

These won't work

202-v1-123.v1
202-v1-123.rom
202-v1-123.bin

Basically having something coming after the "v1" (or c1, m1, etc) and before the extension. Are there roms out there like that? I can always expand to let this pattern work too.

 

[city41]

You can now make .neo files using this website:

To NeoSD

Convert a Neo Geo ROM to NeoSD format

toneosd.mattgreer.dev

It is using neosdconv to do the conversion.

So far the website is quite simple, I'll polish it as time permits.

 

[Neo Alec]

That's really slick! Thank you.

Any chance of being able to add title art to the .neo? The ones made without TO's tool are less pretty in the menu, and I'm seeing more of them in my list as time goes on.

 

[city41]

That's really slick! Thank you.

Any chance of being able to add title art to the .neo? The ones made without TO's tool are less pretty in the menu, and I'm seeing more of them in my list as time goes on.

I don't think that is possible, unfortunately. The artwork data is stored on the NeoSD itself, and when you specify a screenshot number you're just picking from the ones TerraOnion provided.

TO might be able to do a firmware update where a screenshot could be embedded into a .neo, but that's just a guess.

 

[Neo Alec]

Oh, interesting. I wasn't aware of that. Thanks.

 

[Tigerskunk]

Just want to say thank your for this tool..
Currently trying to get my homebrew running on a real Neo Geo, and using a Mac.

(btw, WINE doesn't currently work with M1 Macs, so this is still really really helpful)

 

[city41]

(btw, WINE doesn't currently work with M1 Macs, so this is still really really helpful)

Bumping an old thread to say that TerraOnion's NeoBuilder.exe also works with Mono. Which should work on ARM Macs.

You can install Mono here: https://www.mono-project.com/docs/getting-started/install/mac/

Then do "mono NeoBuilder.exe"

I don't use a Mac, but since Mono is available it should work. I now use Mono myself on Linux to launch NeoBuilder.

 

[Neo Alec]

You can now make .neo files using this website:

To NeoSD

Convert a Neo Geo ROM to NeoSD format

toneosd.mattgreer.dev

It is using neosdconv to do the conversion.

So far the website is quite simple, I'll polish it as time permits.

Is it offline now? Is there a mirror?

 

[city41]

Is it offline now? Is there a mirror?

Sorry but I took it down. My tool can not handle various commercial games, and I was getting a lot of people asking me to add that support. My first response was to archive (and basically shut down) the main tool. But upon further thought I opened it up again, but this time I'm only supporting new development with it, ie those making new games and need to test them on a NeoSD.

I just don't have the time to support this tool for all use cases, and to be totally honest, this is something TerraOnion should be doing anyway.

 

[NeoCverA]

Is there a way to reverse a .neo file to dump out the roms?

 

[FRSGames]

Is there a way to reverse a .neo file to dump out the roms?

Ontem consegui separar arquivos manualmente através da edição do software da Elnec do meu programador Beeprog.

Exemplo:
P1 iniciando no endereço 0000800
S1 iniciando no endereço 0004800
M1 iniciando no endereço 0005800

 

[fredjss]

Sorry but I took it down. My tool can not handle various commercial games, and I was getting a lot of people asking me to add that support. My first response was to archive (and basically shut down) the main tool. But upon further thought I opened it up again, but this time I'm only supporting new development with it, ie those making new games and need to test them on a NeoSD.

I just don't have the time to support this tool for all use cases, and to be totally honest, this is something TerraOnion should be doing anyway.

Hi friend,

Couldn't you make an installable version available on Windows with a graphical tab? This command line is complicated for some (including me). I can't get it to work for the Karnov game, for example.

 

[kernow]

Hi friend,

Couldn't you make an installable version available on Windows with a graphical tab? This command line is complicated for some (including me). I can't get it to work for the Karnov game, for example.

How about you do it
Or learn how to use the cli tool?
..or learn how to make a windows gui jeez

 

[Neo Alec]

Hi friend,

Couldn't you make an installable version available on Windows with a graphical tab? This command line is complicated for some (including me). I can't get it to work for the Karnov game, for example.

Yeah, it's a pain in the ass, but the whole system is tits once it's working.

Get the Backbit cart if you don't want to build .neo files. It solves this.

 

[fredjss]

Sorry @kernow and @Neo Alec ,

I really don't understand anything about computing/programming, and it's like I suddenly want to develop a new equation for the Theory of Relativity. I really don't know.

Sorry for sounding lazy.