https://github.com/kchapelier/node-glitch

Glitched stream for intentional data corruption.
https://github.com/kchapelier/node-glitch

Last synced: about 2 months ago
JSON representation

Glitched stream for intentional data corruption.

• Host: GitHub
• URL: https://github.com/kchapelier/node-glitch
• Owner: kchapelier
• License: mit
• Created: 2014-02-01T18:55:52.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2014-02-02T08:52:44.000Z (over 10 years ago)
• Last Synced: 2024-06-28T14:41:37.565Z (3 months ago)
• Language: JavaScript
• Size: 137 KB
• Stars: 11
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# glitch

Glitched stream for intentional data corruption.

## install

With [npm](http://npmjs.org) do:

```

npm install glitch

```

## API reference

### glitch(fileSrc, fileDst, probability, deviation, mode)

* fileSrc : Source file.

* fileDst : Destination file.

* probability : Probability of deviation per byte (between 0 and 1).

* deviation : Maximum value deviation per byte.

* mode : File mode

### new glitch.GlitchedStream(options);

Transform stream implementation.

Options :

* probability : Probability of deviation per byte (between 0 and 1).

* deviation : Maximum value deviation per byte.

* whiteList : Array of whitelisted values, if set only bytes with those values will be modified.

* blackList : Array of blacklisted values, no byte with those values will be modified.

* deviationFunction : Replace the default deviation function of the stream, allows to write more complex filtering than whitelisting and blacklisting

## Examples

```js

var glitch = require('glitch');

glitch('test.jpg', 'test.glitched.jpg', 0.0001, 2, 0777);

```

Copy a glitched version of test.jpg as test.glitched.jpg where each byte has probability of 1/10000 of having its value modified by a maximum of 2.

```js

var GlitchedStream = require('glitch').GlitchedStream;

var gstream = new GlitchedStream({

  'deviation' : 1,

  'probability' : 1,

  'whiteList' : [0xcc,0xcd,0xce,0xcf]

});

someMidiStream.pipe(gstream).pipe(someMidiReceiver);

```

Pipe a midi stream into a glitched stream which will modify every bytes matching the whitelist by a maximum value of 1 before piping it into midiReceiver.

## Potential use case

* Glitching text files and images (though you'll end up with a lot of totally unreadable files).

* Testing applications or libraries against failure.

* Celebrating april's fool day at the expense of a grunt/gulp user.

## License

MIT