Contents

# AviGlitch

[![Gem Version](https://badge.fury.io/rb/aviglitch.svg)](https://badge.fury.io/rb/aviglitch)
[![test](https://github.com/ucnv/aviglitch/actions/workflows/ruby.yml/badge.svg)](https://github.com/ucnv/aviglitch/actions/workflows/ruby.yml)

AviGlitch destroys your AVI files.

I can't explain why they're going to destroy their own data, but they do.

You can find a short guide at <https://ucnv.github.io/aviglitch/>.
It provides a way to manipulate the data in each AVI frames.
It will mostly be used for making datamoshing videos.
It parses only container level structure, doesn't parse codecs.

See following urls for details about visual glitch;

* vimeo <http://www.vimeo.com/groups/artifacts>
* wikipedia <http://en.wikipedia.org/wiki/Compression_artifact>

## Usage

```ruby
  require 'aviglitch'

  avi = AviGlitch.open('/path/to/your.avi')
  avi.glitch(:keyframe) do |data|
    data.gsub(/\d/, '0')
  end
  avi.output('/path/to/broken.avi')
```

This library also includes a command line tool named `datamosh`.
It creates the keyframes removed video.

```sh
  $ datamosh /path/to/your.avi -o /path/to/broken.avi
```

For more practical usages, please check <https://github.com/ucnv/aviglitch-utils/tree/master/bin>.

## Installation

```sh
  gem install aviglitch
```

## Known issues

- This library doesn't support AVI2 format spec. This means that it will not work as expected for files larger than 1GB.

## License

This library is distributed under the terms and conditions of the [MIT license](LICENSE).

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
aviglitch-0.1.6	README.md