RoughDraft is a fun PowerShell Module for Multimedia.
It provides pipeline-aware command to create, convert, query, edit, and join multimedia files.
The core of RoughDraft are the -Media commands:
| Name | Description |
|---|---|
| Convert-Media | Converts media between formats |
| Edit-Media | Edits media files |
| Get-Media | Gets media metadata |
| Join-Media | Joins media files |
| New-Media | Creates media files |
| Recieve-Media | Receives media from devices |
| Set-Media | Sets media metadata |
| Show-Media | Shows media files |
| Split-Media | Splits media files |
| Send-Media | Broadcasts media |
These commands are built atop of FFMpeg
All Media Commands are Extensible. See the list of extensions
# Converts a Movie.mkv to MP4
Convert-Media .\Movie.mkv mp4
# Converts an .mp4 file to an .mp3
Convert-Media .\Movie.mp4 .\Soundtrack.mp3
# Get rid of flac files
Convert-Media .\Song.flac .mp3
# Convert all .flac files to .mp3
Get-ChildItem -Path $home\Music -Recurse |
Where-Object Extension -eq '.flac' |
Convert-Media .mp3# Adds a sepia effect to an .mp4
Edit-Media .\Movie.mp4 -Sepia
# Increases the audio by 4 decibals.
Edit-Media .\Song.mp3 -AudioGain 4db# Get metadata about an mp3
Get-Media .\Song.mp3
# Detect silences within a song
Get-Media .\Song.mp3 -SilenceDetect
# Gets metadata about a movie.
Get-Media .\Movie.mp4 # Make a timelapse from a directory of pictures
dir *.jpg | Join-Media -OutputPath .\Timelapse.mp4 -Timelapse
# Join an audio and video file
Join-Media -InputPath .\Silent.mp4, .\Soundtrack.mp3 -OutputPath .\Movie.mp4
# Join mp3s into an album
dir *.mp3 | Join-Media -Output ..\Album.mp3
# Join various video files into a longer movie
dir | Where-Object Extension -in '.mkv', '.mp4' | Join-Media -Output ..\Movie.mp4 # Create a red jpg
New-Media -Color Red -OutputPath .\Red.jpg
# Create a 15 second cyan mp4 at 1080p
New-Media -Color Cyan -OutputPath .\Cyan.mp4 -Duration '00:00:05' -Resolution '1920x1080'
# Create an RGB test source
New-Media -TestSource rgbtestsrc -OutputPath .\rgbtestsrc.mp4 -Duration '00:00:10' # Set metadata about a video
Set-Media .\Movie.mp4 -Property @{title='My Movie'}
# Sets metadata about a music file.
Set-Media .\Song.mp3 -Property @{title='My Song';artist='me';'lyrics-eng' = 'My Lyrics'}
# Sets album artwork
Set-Media .\Song.mp3 -AlbumArt .\Cover.jpg| Name | Description |
|---|---|
| Get-FFMpeg | Gets FFMpeg |
| Get-FFPlay | Gets FFPlay |
| Get-FFProbe | Gets FFProbe |
| Get-FFProbe | Uses FFProbe directly |
| Get-RoughDraftExtension | Gets RoughDraftExtensions |
| Use-FFMpeg | Uses FFMpeg directly |
| Use-FFPlay | Uses FFPlay directly |
| Use-FFProbe | Uses FFProbe directly |
# List available codecs
Get-FFMpeg -ListCodec
# List available codecs
Get-FFMpeg -ListCaptureDevice
# List available filters
Get-FFMpeg -ListFilter
# Get information about a filter
Get-FFMpeg -FilterNameRoughDraft uses Extensions to make complex media scenarios easier work with. There are currently 117 extensions:
| DisplayName | Synopsis | Extends |
|---|---|---|
| AlbumArt | Sets album artwork | Set-Media |
| AmplifyPixel | AmplifyPixel extension | Edit-Media,Show-Media |
| AudioCrusher | Audio Crusher | Edit-Media,Show-Media |
| AudioExpression | Evaluates Audio Expressions | Edit-Media,Show-Media,New-Media |
| AudioFrequencyExpression | Apply expressions to audio frequencies | Edit-Media,Show-Media |
| AudioGain | Increases audio volume | Edit-Media,Show-Media |
| BilateralSmooth | Bilateral Smooth | Edit-Media,Show-Media |
| BlackDetect | Detect black periods in a video. | Get-Media |
| BlackFrame | Detects black frames. | Get-Media |
| BlendFrame | BlendFrame Extension | Edit-Media,Join-Media,Show-Media |
| BlendVideo | BlendVideo Extension | Join-Media |
| Blur | Blurs Video | Edit-Media,Show-Media |
| CaptureDevice | Gets capture devices | Get-FFMpeg |
| Chorus | chorus | Edit-Media,Show-Media |
| ChromaHold | chromahold | Edit-Media |
| Codecs | Lists codecs | Get-FFMpeg |
| ColorContrast | ColorContrast Extension | Edit-Media,Show-Media |
| ColorExpression | Color Expression | Edit-Media,Join-Media,Show-Media |
| ColorHold | ColorHold Extension | Edit-Media,Show-Media |
| Colorize | Colorize a video stream | Edit-Media,Show-Media |
| ColorScope | Colorscope extension | Edit-Media,Show-Media |
| ColorSource | Generates a color | Show-Media,New-Media |
| Convolve | convolve | Join-Media |
| Crop | Crop Extension | Edit-Media,Send-Media,Receive-Media,Show-Media |
| CropDetect | Auto-detect the crop size. | Get-Media |
| CrossFade | acrossfade | Join-Media |
| DataScope | Datascope effect | Edit-Media |
| Deconvolve | deconvolve | Join-Media |
| DirectShow | DirectShow Extension | Send-Media,Receive-Media,Show-Media |
| DrawSubtitle | Draw subtitles on top of input video | Edit-Media,Convert-Media |
| DrawText | Draws Text on Video | Edit-Media,Show-Media |
| Echo | Adds echoes to audio | Edit-Media,Show-Media |
| EdgeDetect | EdgeDetect Extension | Edit-Media,Show-Media |
| Emboss | Embosses video or images | Edit-Media |
| Erosion | Erode Video | Edit-Media,Show-Media |
| Exposure | Exposure Extension | Edit-Media,Show-Media |
| ExtractSubtitle | Extract Subtitle Extension | Convert-Media |
| FadeIn | Fades in video | Edit-Media |
| FillBorder | Fill Borders. | Edit-Media,Show-Media |
| FilterInput | Gets filter details | Get-FFMpeg |
| FiniteEqualizer | Finite Equalizer | Edit-Media,Show-Media |
| FixPlaylistPath | FixPlaylistPath | Repair-Media |
| Flanger | Audio Flanger. | Edit-Media,Show-Media |
| FlipHorizontal | Flips video horizontally | Edit-Media,Show-Media |
| FlipVertical | Flips video vertically | Edit-Media,Show-Media |
| FrameBuffer | FrameBuffer Extension | Send-Media,Receive-Media,Show-Media |
| FrameStep | FrameStep Effect | Edit-Media,Show-Media |
| GdiGrab | GDIGrab Extension | Send-Media,Receive-Media,Show-Media |
| GifPalette | Gif Palette Extension | Convert-Media |
| Histogram | Histogram Extension | Edit-Media,Show-Media |
| Hue | Hue Extension | Edit-Media,Show-Media |
| Hysteresis | Hysteresis | Join-Media |
| LagFun | Slowly update darker pixels. | Edit-Media,Show-Media |
| Life | Generates life | Show-Media,New-Media |
| LimitPixel | Limits Pixel values | Edit-Media,Show-Media |
| ListFilters | Lists filters | Get-FFMpeg |
| ListProtocols | Lists protocols | Get-FFMpeg |
| Mandelbrot | Generates fractals | Show-Media,New-Media |
| MedianPixel | Picks median pixels | Edit-Media,Show-Media |
| Mirror | Mirror Extension | Edit-Media,Show-Media |
| MixAudio | Mix Audio | Join-Media |
| MixVideo | Mix Video | Join-Media |
| Monochrome | Make video monochrome | Edit-Media |
| NoAudio | Removes Audio | Split-Media |
| NoLogo | delogo | Edit-Media,Show-Media |
| OffsetAudio | Offset the audio signal | Edit-Media,Convert-Media |
| OffsetVideo | Offset the audio signal | Edit-Media,Convert-Media |
| Overlay | overlay | Join-Media |
| Phaser | Audio Phaser | Edit-Media,Show-Media |
| PitchFactor | Adjust Pitch by a factor | Edit-Media,Show-Media |
| Pixelate | Pixelate effect | Edit-Media |
| Playlist | Creates a playlist | Join-Media |
| PseudoColor | pseudocolor | Edit-Media |
| Pulsator | Pulsator Effect | Edit-Media,Show-Media |
| RandomizeFrame | RandomizeFrame extensions | Edit-Media,Show-Media |
| Rate | Adjusts the rate of media. | Edit-Media,Show-Media |
| Resize | Simple video resize. | Edit-Media,Convert-Media,Show-Media |
| ReverseAudio | Reverses audio | Edit-Media |
| ReverseVideo | Reverses video | Edit-Media |
| Rotate | Rotates a video | Edit-Media,Convert-Media,Show-Media |
| Scale | Scales video. | Edit-Media,Show-Media |
| ScrollVideo | Scrolls video | Edit-Media,Show-Media |
| Sepia | Applies a Sepia Filter | Edit-Media |
| ShowFrequency | Show Frequencies | Edit-Media,Show-Media,New-Media |
| ShowScale | Show the tonal scale of the audio | Edit-Media,Show-Media,New-Media |
| ShowSpectrum | Shows the audio spectrum | Edit-Media,Show-Media,New-Media |
| ShowVectorScope | Shows a Vector Scope of the Audio | Edit-Media,Show-Media,New-Media |
| ShowVolume | Shows the volume of an audio stream. | Edit-Media,Show-Media,New-Media |
| ShowWaveform | Shows audio waveform. | Edit-Media,Show-Media,New-Media |
| ShuffleFrames | Shuffles frames in video | Edit-Media |
| ShufflePixels | Shuffles frames in video | Edit-Media |
| ShufflePlanes | Shuffles planes in video | Edit-Media |
| Sierpinski | Generates a Sierpinski fractal | Show-Media,New-Media |
| SilenceDetect | Detects silence in an audio stream | Get-Media |
| SilenceRemove | Detects silence in an audio stream | Edit-Media |
| Sine | Generates a sine wave | New-Media |
| Skew | Skew Extension | Edit-Media,Show-Media |
| SplitEqually | Splits Media Equally | Split-Media |
| SubFrequencyCut | Cut subwoofer frequencies | Edit-Media,Show-Media |
| Subtitler | Creates subtitles. | New-Media |
| SuperEqualizer | Audio 18 band Superequalizer | Edit-Media,Show-Media |
| SuperFrequencyCut | Cut super frequencies. | Edit-Media,Show-Media |
| SwapRect | swaprect | Edit-Media |
| Tempo | Adjust audio tempo. | Edit-Media,Show-Media |
| TestSource | Generates test sources | Show-Media,New-Media |
| Tile | Tile Extension | Edit-Media |
| TimeMix | Mix successive video frames. | Edit-Media,Show-Media |
| Tremolo | Tremolo effect | Edit-Media,Show-Media |
| Vibrance | vibrance | Edit-Media |
| Vibrato | Vibrato effect | Edit-Media,Show-Media |
| VideoExpression | Evaluates Video Expressions | Edit-Media,Show-Media |
| VideoForLinux | VideoForLinux Extension | Send-Media,Receive-Media,Show-Media |
| Vignette | Applies a vignette filter | Edit-Media,Show-Media |
| VolumeLevel | Gets VolumeLevels | Get-Media |
| Watermark | Watermarks a video | Edit-Media |
| YouTubeDL | Youtube Downloader | Get-Media |
| ZoomPan | Zoom and Pan | Edit-Media,Show-Media |
RoughDraft is built extensibly. This is so that complex FFMpeg operations can be abstracted into small amounts of code.
You can see the current set of extensions with:
Get-RoughDraftExtensionExtensions are simple scripts files named with the regular expression \.(rd|RoughDraft)\.(ext|extension)\.ps1$.
They can exist in any module that adds the tag "RoughDraft".
Extensions should include the following attributes above their parameter block:
# It's an extension
[Runtime.CompilerServices.Extension()]
# that extends Edit-Media
# (Change this to indicate which command you'd like to extend)
# (Add additional Cmdlet attributes one to extend more commands)
[Management.Automation.Cmdlet("Edit","Media")]
# that is inherited (this is the default).
# (an extension that is 'Inherited' will return control to the main function when it is done.)
# (an extension that is 'NotInherited' will run and return directly)
[ComponentModel.Inheritance("Inherited")]
param(
# At least one parameter of the extension should be mandatory.
[switch]
$MyEditExtension
)The following commands can currently be extended:
- Convert-Media
- Edit-Media
- Get-FFMpeg
- Get-Media
- Join-Media
- New-Media
- Recieve-Media
- Set-Media
- Send-Media
- Show-Media
- Split-Media