byebyte - destroy your files in the name of art

byebyte 1.0.0 is out! This has breaking changes to the API from 0.0.3; read this README to learn how to use it. If you need the old README, it is here.

What?

byebyte is a command line tool written in Node.js that replaces random bytes in a file with random values.

byebyte can also be used as a node module. For info on how to use byebyte this way, please see ./node-module.md.

Why would I want to do that?

Because you like glitch art or you just need to destroy arbitrary data in a file for some reason while leaving most of it intact. Potential uses:

• Destroying various image files
• Glitching video files
• Randomizing text files
• Breaking your essay file so that your teacher can't open it and you get your deadline extended

Installation

You'll need Node.js 6 to run this file, so you need that installed first. You'll also need to learn how to use a command line. Once you have Node, you can install byebyte pretty easily:

npm install -g byebyte

Usage

You're set up! Byebyte has two modes, destroy and shuffle, as well as a series of global paramaters that are necessary with every command. The global parameters are as follows:

parameter	meaning	default
-i, --input	input file path	none, required
-o, --output	output file path	none, required
--min	the lower bound of the file to alter bytes in - use percentage 0 to 1 (ex: 0.15 = 15%, 1 = 100%). If specified, you cannot use --start or --stop	none, required
--max	the upper bound of the file to alter bytes in - use percentage from 0 to 1 (ex: 0.15 = 15%, 1 = 100%). If specified, you cannot use --start or --stop	none, required
--start	a specific point at the file, in bytes, at which to begin altering bytes. If specified, you cannot use --min or --max	none, required
--stop	a specific point at the file, in bytes, at which to stop altering bytes. If specified, you cannot use --min or --max	none, required

They're global because they are used by all commands in order to tell byebyte what file to alter as well as what portion of the file to alter.

• Use -i or --input to specify the file to change, and -o or --output to specify the target path for the resulting modified file.
• Use --min and --max to alter a percentage range of the file (for instance, --min 0.2 and --max 0.8 on a 200 byte file will cause changes within only bytes 40 to 160).
• Use --start and --stop to specify a specific byte range.
• You can only use --min and --max or --start and --stop.

destroy mode

You can destroy files with the destroy command, which will replace random bytes in the file with trash data. For example, let's say I have this poem named baby.txt:

Little Baby

Little baby Oh so small 
One day you will be big and tall
I watch you while you laugh and play 
My love for you grows everyday 
I tell you this with my whole heart
I love you just the way you are

I can destroy it with the following command:

byebyte destroy -i baby.txt -o baby_destroyed.txt --min 0 --max 1

This short little poem is written to a new file, baby_destroyed.txt, which looks like:

Little Baby

Little baby Oh ±oDsmall 
2neHdayàyou wi�l be2digJañd�tall
� watch�youìw°ile9you l³ugh and play 
My lo�e f�r*you õrHws everydayB
‚ tell youÖt³is with myäÏhole�heart
I Zove óou just the way you are

You can specify how many times you want to replace bytes in the file by using the --times or -t flag. For instance, we can replace 100 bytes in the first half of the poem with the following command:

byebyte destroy -i baby.txt -o baby_destroyed2.txt --min 0 --max 0.5 -t 100

We then get:

/it?��?a|?

??[?_ ֍???h:�?�,??>] ??e?:a: ?u ?ll?b? bi}?n?%tal?I �atch�???.hil?youTl??g?i>/?n?y 
My love for you grows everyday 
I tell you this with my whole heart
I love you just the way you are

Note that since the first half of the poem is only just under 90 bytes, replacing 100 bytes actually replaces some of the 90 bytes multiple times.

destroy also works great on images. Here's the byebyte "logo" after running it through byebyte:

byebyte -i byebyte.jpg -o byebytebroke.jpg -t 100

We can even do it again to the same image:

Here's a panda:

Here's the command:

byebyte -i byebyte.jpg -o byebytebroke.jpg -t 13000 -c false

Here's the result:

BMPs have really simplistic data, so breaking them doesn't do a ton.

Video works well, too.

Here's a cool, comforting video: find comfort in the light. // full moon timelapse

Here's the end example of my destroying parts of it and exporting a single part from the destroyed video as a GIF:

Here's the full result of the piece I made:

Continuous mode

The destroy command can use a "continuous mode" which means that every time a byte is replaced, there's a random chance that the next byte to be replaced will immediately follow the byte that was just replaced. This results in streams of corrupted data as opposed to a uniform distribution of data. Take the following example of a field of periods:

............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................

We can turn on the continuous behavior by setting --continuous or -c to true:

byebyte destroy -i example.txt -o example_continuous.txt --min 0 --max 1 -t 200 --continuous true

And we get:

.......�òéAþÂ..........................HôŒÛ......4..........
.....................................“..........�gYW-......
........’bSíŸU............¢....e�...........S´nÏ8š........+.
....”’öØ�ˆ…7.....A..........©}è]....�.....{..........x÷�W...
...........÷................................................
.........Ø".......Ì.....................Ö.......‹....À�..÷..
...................+..../.mÌR¤¶..................�..........
..........ìݸ±iFµ...............�öÔœá.. ....................ä‚L......................ÁQ›Ð-׸..........................�..
..........................9°��.........©....................
..............î......................¬|&6ú..................
.?.\¯é....�......Å................±rŸ.....xß................
.............................�*
²...�..............n	ä..Ä.
...........................y.......åO......!................
..............................................ƒ..tçë.......t³...............................�¨0.....IÖÕç�ó.............
....................................Ö�{¸-.......�......... .
.........,å¼....................................èQ×..èÉ....�q!..._Üë............d...p..œ�................................
.................................w........µ.................
............................................................
Ë ª¼Ø.......................................fjÍnJ...........

Note how many of the corruptions are clustered due to the continuous behavior. We can exaggerate the effect by affecting the random chance with the --continous-chance or -C parameters:

byebyte destroy -i example.txt -o example_continuous.txt --min 0 --max 1 -t 200 -c true -C 0.98

............................................................
............................................................
............................................................
............................................................
.................................q•:�"úC®?ËôGì‘J�»\äˆ%�¨}Q·�]:�6¨�gUžÆË‘oBìí¼s�D¡€À?.....................................
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................
.............................................,EéEÈ4Xª�H'ñ¬�©²»¨ƒxáÙ%tAÅØœüL«–º�džýÛ�“8� .......................-yQ(ãÐ+îvFeu.ÞA��Rx6±þîjCçÂÐÔ�ñ‹#ÖÉ"ŒJSªœ˜’ž‹šª˜V;�8=à;pg���+„�BY®–��¥�G|�ô�ãø�J!¿l¥�LkäàävÓH............._älZ/l€ÇÅ´“{©.............
............................................................
............................................................
............................................................
............................................................
............................................................
............................................................

shuffle mode

Shuffle mode will allow you to shuffle the contents of a file. Let's look at our baby poem example again.

Little Baby

Little baby Oh so small 
One day you will be big and tall
I watch you while you laugh and play 
My love for you grows everyday 
I tell you this with my whole heart
I love you just the way you are

To shuffle this file, we can use the shuffle command.

byebyte shuffle -i baby.txt -o baby_shuffle.txt --min 0 --max 1 --chunk-min 20 --chunk-max 50

The global parameters -i, -o, --min, and --max still remain the same, but there are two new required parameters, --chunk-min and --chunk-max which respectively define the minimum and maximum length that chunks should be.

We get the following result to baby_shuffle.txt:

ou will be big and tall
I watch yoou grows everyday 
I tell you this wiLittle Baby

Little babyth my whole heart
I love you ju Oh so small 
One day yu while you laugh and play 
My love for yst the way you are

Shuffling also has some interesting effects on images, particularly rawer formats like .TIFF:

Video files tend to get thoroughly destroyed, but with some potentially interesting effects, and audio files also get destroyed in weird ways. Here's a link to a video example.

This is awesome

Yeah? I'm glad you said so, because I happen to have a whole bunch of glitch art resources on my personal website/newsletter Glitchet, not to mention a pretty kickass Facebook page and Tumblr. Feel free to send any feedback / questions to [email protected].