Skip to content

mateoconlechuga/convbin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.
    8xp-compressed: Compressed TI Program.
    8xg: TI Group. Input format must be 8x.
    8xg-auto-extract: TI Auto-Extracting Group. Input format must be 8x.
    b83: Pack input files into TI-83 Premium CE bundle.
    b84: Pack input files into TI-84 Plus CE bundle.
    zip: Pack input files into zip archive.

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.
        miniz: (c) 2010-2014 by Rich Geldreich.