fosres / TSCD

Official Repository For tscd ASCII-Color Encoded Hex Dump

TSCD Hex Dump

Introducing tscd: A Hex Dump For 256-bit ASCII Color-Supporting Terminal Emulators

SUPPORTED PLATFORMS/TERMINALS

• CYGWIN on Windows

• macOS-Terminal

• macOS-iTerm2

• All Linux Terminal Emulators

Download Options

Option 1 - Using aria2c:

Step 1

aria2c https://raw.githubusercontent.com/tanveerasalim/TSCD/master/src/tscd6.c

Step 2

gcc tscd6.c -o tscd

mv tscd /usr/local/bin

Option 2 - Cloning Into Repository:

Step 1

git clone https://github.com/tanveerasalim/TSCD.git

Step 2

cd TSCD/

cd src/

gcc tscd6.c -o tscd

sudo cp tscd /usr/local/bin

Option 3 - Use Install Script After Git Clone:

NOTE: Will NOT Work in CYGWIN

Step 1

git clone https://github.com/tanveerasalim/TSCD.git

Step 2

cd TSCD/

sudo chmod u+x install.sh

./install.sh

(Optional: Verify SHA Checksums)

SHA CHECKSUMS (text file of SHA1, SHA256, and SHA512 checksums in shasums.txt):

SHA1SUM

1c4d47967e12dfb8d824b3c380b304af9a70adef *tscd6.c

SHA256SUM

b6d3024cf3c8802ffc4c5d64b5004d282a5328e00abb20e6c771ea57b42f7230 *tscd6.c

SHA512SUM

be29d2ea8c2c01b043853d1ab366bc2ba0458e3ef9842924de87220e3434b881d639a6f5154a4d407e81b3076acc9b9a66903fe9c9dc5e1a88e2444f6533ad93 *tscd6.c

Manual

NAME

tscd

SYNOPSIS

tscd [options] [infile [outfile]]

DESCRIPTION

tscd can create a hexadecimal, decimal, binary, or octal dump of any file. The numerical values will be displayed in a table.To the rightmost of each row will be the ASCII characters corresponding to the ASCII codes in the table.

COLOR ENCODINGS

Below Is The Color Encoding Scheme (ASCII):

OPTIONS

-b Binary dump specified. Each character in file will be translated into its binary number form and displayed in the table.

-c [Number of Columns] Specify number of columns per row in ASCII code table.

-d Decimal Dump specified. Each character in file will be translated into its binary number form and displayed in the table.

-o Octal Dump specified. Each character in file will be translated into its octal number form and displayed in the table.

-p Print view specified. tscd will simply print the contents of the file directly intointo stdout.

EXAMPLES

Print simple hexdump of a file to stdout

Print simple hexdump of a file where 16 ASCII hexadecimal codes are printed per row to stdout

Print binary dump of a file named tscd4.c to stdout

Print binary dump of a file named swiss.txt where up to four binary octects appear per row, to stdout

Print binary dump of a file named swiss.txt to a separate file named swiss_binary_dump.txt

Step 1:

Step 2:

(The file below is being viewed in vim. No color codes can be encoded into a text file.)

LICENSE STATEMENT AND COPYLEFT PERMISSIONS

tscd: A 256-bit ASCII Color Encoded Hexdump Program Copyright (C) 2019 FOSRES

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.