how do i even run the program?? (linux)

[epicsatehepicone]

not even sure how i open it? the .cmd file does nothing

[PerfectMach1ne]

You might wanna make sure you made your CLI file executable to begin with. To do that you open a terminal in the directory with ImageMap4-Linux executables, and run chmod +x ImageMap-cmd.
Running ./ImageMap-cmd should print out the help & usage message.

[PerfectMach1ne]

Also if you have any maps you care about, you might wanna look into your [savefilefolder]/data/idcounts.nbt with https://irath96.github.io/webNBT/ , take the number you find in this file, increment it by 1 and run this:

./ImageMap-cmd '<path-to-your-world>' --import image.png --id <last-map-id+1>

I have 948 maps and I wanted none of them overwritten, so I ran --id 949.

[tryashtar]

You can omit --id to automatically select the first available ID