README

This fork is no longer maintained in favor of https://gitlab.com/bunnylin/bin2iso.

So please use https://gitlab.com/bunnylin/bin2iso instead.



Description:

  bin2iso converts RAW format (.bin) files to ISO/WAV format.

  This is version 1.9b from http://users.andara.com/~doiron (dead link) plus
  port to DOS and some patches by Gentoo Linux and me.

Make:

  Unix and Unix-like:

      clang bin2iso.c -O2 -o bin2iso

    or

      gcc bin2iso.c -O2 -o bin2iso

  DOS:

    paru -S openwatcom-v2
    source /opt/watcom/owsetenv.sh
    export INCLUDE=$WATCOM/h
    wcl bin2iso.c -fe=bin2iso.exe -k12288 -os -bcl=dos

  WIN32:

    i686-w64-mingw32-gcc -O2 -s -static bin2iso.c -o bin2iso.exe

  WIN64:

    x86_64-w64-mingw32-gcc -O2 -s bin2iso.c -o bin2iso.exe

Usage:

  Usage: bin2iso <cuefile> [<output dir>] [-[a]wg] [-t XX] [-i] [-nob]
  or   : bin2iso <cuefile> -c <binfile>

  Where:
     <cuefile>    - the .cue file that belongs to the .bin file to
                    be converted
     <output dir> - the output directory (defaults to current dir)
     -nwg         - indicates that audio data found in the track
                    'gaps' shouldn't be appended to the audio tracks
     -awg         - looks for non-zero data in the 'gaps', if found
                    then gaps are appended to audio tracks. Looks
                    for more than 1/2 of a sector of non-zero values
                    (588 values),
     -t XX        - Extracts the XX'th track.
     -i           - Performs the conversion 'in place'. Meaning it
                    truncates the binfile after each track is
                    created to minimize diskspace requirements.
                    [not valid with -t]
     -nob         - Doesn't use overburn data past 334873 sectors.
                    This of course presumes that the data is not
                    useful.
     -c           - Attempts to create a <cuefile> from an existing
                    <binfile>

License:

  MIT License
  Copyright (c) 1999 Bob Doiron
  Copyright (c) 2020 - 2025 Michael Ortmann

Website:

  https://gitlab.com/mortmann/bin2iso/
  http://users.andara.com/~doiron (dead link)
  https://gitlab.com/bunnylin/bin2iso (yet another fork)
  http://he.fi/bchunk/ (yet another converter)

ICQ:

  Bob Doiron ICQ#280251

Thanks and Greetings to Bob Doiron

Enjoy,
Michael

---------------------------------------------------------------------
NOTE: This is a work in progress!

So far I believe it handles MODE1, MODE2 and AUDIO tracks.

Since I have little exposure to .bin files, and little expertise in 
CD formats, I can't guarantee this will work for all .bin's.

so... TEST the output before burning. Use Winimage on the ISO files  
and a wave player on the WAVs.

If you do run into trouble, send me the following info:
- .cue file
- command line used
- the screen output 
- directory listing of source and files created (with sizes)
and I'll fix it up.

Revision History 

v1.9bm5
  - Fix WAV header / integer types
  - Add fread() error handling

v1.9bm4
 - Fix https://github.com/michaelortmann/bin2iso/issues/3
   Only suffix track name with track number if number of tracks is greater than 1
 - Remove trailing whitespaces

v1.9bm3
 - Added win32 and win64 executable
 - Fixed data argument not used by format string
 - Fixed format specifier
 - Made functions static
 - Removed defined, but not referenced variables
 - Fixed usage output
 - Fixed make DOS wcl command
 - Fixed off-by-one error

v1.9bm2
 - Typo fixes

v1.9bm
 - Ported to DOS
 - Fixed a bug
 - Fixed 2 compiler warnings with linux / glibc / gcc
 - Applied bin2iso-19b-sanity-checks.patch from gentoo

v1.9b
 - Oops.. was no way to turn writegap off: 
   changed -wg option to -nwg

v1.9a
 - Fixed bug in extracting single track
 - changed code to default to writing gap data because of the way 
   easycd pro writes the table of contents for the cd

v1.9
 - revamped internally allowing me to do add some functionality...
   Added a -i option to allow converting a bin using a little diskspace
   as possible. !NOTE! This is destructive to the original .bin
 - No longer barfs on PREGAP lines...
 - Added a -awg option that checks for non-zero data in the gaps between 
   audio tracks and turns on the -wg feature if it finds more than half
   a sector of non-zero values.
 - Added a -nob option that ditches overburn data. I haven't tested this,
   but rumour has it that some cd players can't access data over 74.XX 
   minutes. I'm not sure if I believe this, but I put the option in in
   case I get a chance to try it. (so far untested!)

v1.8b
 - modified the audio gap detection scheme for creating cue files...
   Now it may detect extra gaps, but they are easily removed by editing
   the cuefile. Before it would sometimes not detect gaps, so I think
   this is better.

v1.8
 - Added the ability to create a cuefile from a binfile.
   (assumes MODE1/2352, MODE2/2352 or AUDIO tracks)
 - Added ISO track numbering for cd's with more than one data track

v1.7
 - Made the reads/writes happen in 4Meg chunks... should speed things up 
   when read from and writing to the same disk. (less head thrashing)
 - Added Mode2/2336: When this type of track is encountered, it converts
   it to the trusty Mode2/2352 track we're used to. (Burn with EasyCD
   or open with WinImage)
   Or, if you like, you can rename the output from a .iso to a .bin and then 
   edit the cue file track type from MODE2/2336 to MODE2/2352 to burn with 
   cdrwin.

v1.6
 - Added a '-wg' command switch to make bin2iso append pregap sectors to the
   last wav file. Useful because some cd's have music in the pregaps.
   Note: most TAO burning leaves 2 second gaps between songs, so if you copy
         a copy, then don't use the -wg option. If you do use it, then the 
         audio track will grow by 2 seconds.

v1.5
 - Fixed parsing of the filename from the cue file. (handles spaces etc)
 - Added progress display
 - Detects a single track, mode2 bin which can be burnt as is.
 - Verifies data tracks (checks the mode and frame sequence)

v1.4
 - fixed bug that occurred when tracks had no pregap index
 - parsing of .bin filename out of .cue file now ditches path info
 - fixed bugs in [<output dir>] parsing. (trailing '\' or ':')

v1.3
 - first release to public

Suggested programs:
WinImage - for viewing ISO images
EasyCD Pro 2.11 (020) - for burning ISO or Mixed mode ISO/WAV
                         (rumour is that creator doesn't always burn the 
                          images as is, sometimes screws long filenames
                          or burns a mode2 iso in mode1 form, etc, etc)
Nero - Burning Rom    - For burning AUDIO disks because it allows changing 
                        the gap size on my sony928e.

TROUBLESHOOTING

Don't know of any problems right now. Let me know.