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

Neo Alec

Onigami Isle Castaway
20 Year Member
Joined
Dec 7, 2000
Posts
13,975
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:
(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
Code:
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:

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.
 
Last edited:

city41

Galford's Poppy Trainer
10 Year Member
Joined
Dec 27, 2010
Posts
2,602
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

Galford's Poppy Trainer
10 Year Member
Joined
Dec 27, 2010
Posts
2,602
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
Code:
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

Onigami Isle Castaway
20 Year Member
Joined
Dec 7, 2000
Posts
13,975
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
Code:
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

Galford's Poppy Trainer
10 Year Member
Joined
Dec 27, 2010
Posts
2,602
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.
 

Neo Alec

Onigami Isle Castaway
20 Year Member
Joined
Dec 7, 2000
Posts
13,975
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

Galford's Poppy Trainer
10 Year Member
Joined
Dec 27, 2010
Posts
2,602
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

Onigami Isle Castaway
20 Year Member
Joined
Dec 7, 2000
Posts
13,975
Oh, interesting. I wasn't aware of that. Thanks.
 

Tigerskunk

n00b
Joined
Sep 15, 2021
Posts
7
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

Galford's Poppy Trainer
10 Year Member
Joined
Dec 27, 2010
Posts
2,602

Neo Alec

Onigami Isle Castaway
20 Year Member
Joined
Dec 7, 2000
Posts
13,975
You can now make .neo files using this website:


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

Galford's Poppy Trainer
10 Year Member
Joined
Dec 27, 2010
Posts
2,602
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

My Sub Name
20 Year Member
Joined
Aug 7, 2002
Posts
6,849
Is there a way to reverse a .neo file to dump out the roms?
 

FRSGames

n00b
Joined
Apr 30, 2021
Posts
7
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

n00b
Joined
Sep 14, 2012
Posts
5
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

Superior Being
20 Year Member
Joined
Sep 1, 2001
Posts
37,157
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

Onigami Isle Castaway
20 Year Member
Joined
Dec 7, 2000
Posts
13,975
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

n00b
Joined
Sep 14, 2012
Posts
5
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.
 
Top