convbin icon indicating copy to clipboard operation
convbin copied to clipboard

Converts files to other formats

convbin Build Status Coverity Scan

This program is used to convert files to other formats. It primarily is used for the TI-84+CE and related calculator series, however can be used as a standalone program.

Command Line Help

Usage:
    convbin [options] -j <mode> -k <mode> -i <file> -o <file>

Required parameters:
    -i, --input <file>         Input file. Can be specified multiple times,
                               input files are appended in order.
    -o, --output <file>        Output file after converting.
    -j, --iformat <mode>       Set per-input file format to <mode>.
                               See 'Input formats' below.
                               This should be placed before the input file.
                               The default input format is 'bin'.
    -p, --icompress <mode>     Set per-input file compression to <mode>.
                               See 'Compression formats' below.
                               This should be placed before the input file.
    -k, --oformat <mode>       Set output file format to <mode>.
                               See 'Output formats' below.
    -n, --name <name>          If converting to a TI file type, sets
                               the on-calc name. For C, Assembly, and ICE
                               outputs, sets the array or label name.

Optional parameters:
    -r, --archive              If using the TI 8x* format, mark as archived.
    -c, --compress <mode>      Compress output using <mode>.
                               See 'Compression formats' below.
    -e, --8xp-compress <mode>  Sets the compression mode for compressed 8xp.
                               Default is 'zx7'.
    -m, --maxvarsize <size>    Sets maximum size for the TI 8x* variables.
    -u, --uppercase            If a program, capitalizes the on-calc name.
    -a, --append               Append to output file rather than overwrite.
    -h, --help                 Show this screen.
    -v, --version              Show the program version.
    -b, --comment              Custom comment for TI 8x* outputs.
    -l, --log-level <level>    Set program logging level.
                               0=none, 1=error, 2=warning, 3=normal

Input formats:
    Below is a list of available input formats, listed as
    <mode>: <description>

    bin: Interprets as raw binary.
    csv: Interprets as csv (comma separated values).
    8x: Interprets the TI 8x* data section.

Output formats:
    Below is a list of available output formats, listed as
    <mode>: <description>

    c: C source.
    asm: Assembly source.
    ice: ICE source.
    bin: raw binary.
    8xp: TI Program.
    8xv: TI AppVar.
    8xg: TI Group. Input format must be 8x.
    8xg-auto-extract: TI Auto-Extracting Group. Input format must be 8x.
    8xp-compressed: Compressed TI Program.

Compression formats:
    Below is a list of available compression formats, listed as
    <mode>: <description>

    zx0: ZX0 Compression.
    zx7: ZX7 Compression.
    auto: Tries all compression modes to find the best one.

Credits:
    (c) 2017-2024 by Matt "MateoConLechuga" Waltz.

    This program utilizes the following neat libraries:
        zx0,zx7: (c) 2012-2022 by Einar Saukas.