29/10/2017 GitHub - wayspurrchen/moshy: datamoshing utility kit for common tasks with AVI files

wayspurrchen / moshy

Join GitHub today Dismiss

GitHub is home to over 20 million developers working together to host
and review code, manage projects, and build software together.
Sign up

datamoshing utility kit for common tasks with AVI files

17 commits 1 branch 1 release 2 contributors MIT
Branch: master New pull request Find file Clone or download
wayspurrchen Update README to be more explicit about ffmpeg installation Latest commit 61302d8 on 31 Jan 2016
bin Rework file structure for gemspec 2 years ago
lib Make sure to explicitly specify slop dependency version 2 years ago
.gitignore Rework file structure for gemspec 2 years ago
Gemfile Rework file structure for gemspec 2 years ago
LICENSE.txt Rework file structure for gemspec 2 years ago
README.md Update README to be more explicit about ffmpeg installation 2 years ago
Rakefile Rework file structure for gemspec 2 years ago
moshy.gemspec Make sure to explicitly specify slop dependency version 2 years ago
README.md

moshy

created with moshy's pdupe options

moshy is a command line datamoshing utility kit for AVI files, based heavily on aviglitch. It's designed to make
common datamoshing tasks easier without having to open avidemux or other GUI tools. It lets you do stuff like:
Convert video files into AVI video files with minimal I‑Frames and no B‑frames for ultimate moshability
Create P‑Frame duplication effects quickly
Split a long video file into multiple clips based on its I‑Frames
"Bake" your datamoshed video, encoding the corruption as actual video content for uploading to video services
or moshing even further!
Identifying keyframe and deltaframe indexes in any AVI file
...and more!
If you don't know how to use the command line, this is a great opportunity to learn:
Mac OS X Tutorial: http://blog.teamtreehouse.com/introduction‑to‑the‑mac‑os‑x‑command‑line
Windows Tutorial: http://lifehacker.com/5633909/who‑needs‑a‑mouse‑learn‑to‑use‑the‑command‑line‑for‑
almost‑anything
Get it!
https://github.com/wayspurrchen/moshy 1/3
29/10/2017 GitHub - wayspurrchen/moshy: datamoshing utility kit for common tasks with AVI files
You'll need to install Ruby. If you're on Mac OS X, you probably already have a local version of Ruby installed. Once
that's done, you can use Rubygems (which comes with Ruby) to install moshy:
gem install moshy

From there, you can use  moshy  from the command line.
For a couple commands ( prep  and  bake ), you need to have ffmpeg installed locally. You can get it for your OS here.
What's it do?
Moshy currently has six different modes:
 prep  ‑ Preps a video file for datamoshing with moshy by converting it into an AVI with no B‑Frames (they're not
good for moshing), and placing as few I‑Frames as possible. Requires ffmpeg be installed locally.
 isplit  ‑ Extracts individual clips from an AVI where each clip is separated by I‑frames in the original AVI. Great
for getting specific clips out of a larger video and later doing I‑frame moshing.
 inspect  ‑ Reads an .avi file and prints which video frames are keyframes (I‑Frames) and which frames are delta
frames (P‑frames or B‑frames). moshy cannot tell the difference between a P‑frame or a B‑frame, so you will
want to use avidemux or another program if you need to know.
 pdupe  ‑ Duplicates a P‑frame at a given frame a certain amount. To find out which frames are P‑frames, use
software like avidemux to look at the frame type. WARNING: This mode is a little glitchy. You may need to set the
interval 1 or 2 above or below the frame number you actually want to duplicate. I'm not sure why this happens,
but try it with a small duplication amount first. NOTE: This can mode take a while to process over 60‑90 frame
dupes.
 ppulse  ‑ Takes c number of frames and every n frames and duplicates them a given amount, resulting in a
consistent P‑duplication datamosh that's good for creating rhythmic effects. This was originally created to create
mosh effects in sync with a beat for a music video.
 bake  ‑ "Bakes" your datamosh by creating a new video file from your datamoshed .avi, causing the datamosh
effects to be treated as the actual content of the new video instead of an error. Requires ffmpeg to be installed
locally.
You can access detailed info on how to use each of them from the command line with the command  moshy -m <mode>
--help .

Cool!
If you think this is cool, you'll probably find my list of glitch art resources useful as well as the Glitchet newsletter, a
free weekly futuristic news and glitch aesthetic e‑zine.
Quick tutorial
Here's a short example of how you might use moshy to create a P‑dupe mosh:
1. Choose a YouTube video you want to mosh (I'll use "Charlie bit my finger": https://www.youtube.com/watch?
v=bnRVheEpJG4)
2. Download it with KeepVid (http://keepvid.com/?
url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DbnRVheEpJG4)
3. "Prep" it with moshy to turn it into an .AVI with minimal I‑Frames and all P‑frames (because B‑frames don't mosh
well):
 moshy -m prep -i charlie.mp4 -o charlie.avi 

4. Open charlie.avi in avidemux and clip it down to the segment I want (moshy will soon be able to do this with a
"clip" command):

https://github.com/wayspurrchen/moshy 2/3
29/10/2017 GitHub - wayspurrchen/moshy: datamoshing utility kit for common tasks with AVI files
5. Open charlie_clip.avi and find the frame I want to P‑dupe mosh (here, frame 196):

6. Use moshy in pdupe mode to dupe frame 196 60 times:

 moshy -m pdupe -i charlie_clip.avi -f 196 -d 60 -o charlie_clip-dupe.avi 
Open it in a video player (I use VLC) and see if it looks good.
7. Awesome, I love it, but I want to clip it down to size. However, since it has so few I‑frames, if I just clip it
anywhere, the beginning of the video will become corrupted because of lack of pixel data. Let's use moshy to
bake the mosh:
 moshy -m bake -i charlie_clip-dupe.avi -o charlie_clip-dupe-bake.avi 

8. Done. Let's open it back up in avidemux, clip it down to size, and save our final result:

9. Looks good to me. Let's save it as an MP4 so that I can upload it to Giphy, which will convert it into a .gif for me.
(I'm hoping to add modes to moshy that convert videos to .gif and .mp4 directly, too.)
10. Done!
Trouble?
Having issues? Please file an issue!

https://github.com/wayspurrchen/moshy 3/3