|
| 1 | +--- |
| 2 | +title: Import/Export movie using FFmpeg |
| 3 | +name: FFmpegVideoImportExport |
| 4 | +categories: [Import-Export] |
| 5 | +source-url: https://github.com/anotherche/imagej_ffmpeg_video |
| 6 | +release-date: March 11 2025 |
| 7 | +release-version: 0.6.0 |
| 8 | +dev-status: Active |
| 9 | +support-status: Active |
| 10 | +team-founders: "@anotherche" |
| 11 | +team-maintainers: "@anotherche" |
| 12 | +--- |
| 13 | + |
| 14 | +## Overview |
| 15 | + |
| 16 | +The plugin allows you to import and export video files using the JavaCV interface to FFmpeg. |
| 17 | +It supports all formats and compression methods known to ffmpeg (i.e. virtually all known video types). |
| 18 | + |
| 19 | +During import you can select the necessary frame range and perform the simplest operations on images like flip and convert to grayscale. |
| 20 | +The resulting sequence of images is displayed as a virtual image stack (optionally decimated) or converted to a 5D hyperstack with customizable field order and number of z-slices and time-frames. |
| 21 | + |
| 22 | +Export allows you to save the image stack or hyperstack to video in the required format and compression. |
| 23 | + |
| 24 | +The plugin depends on another plugin - [JavaCV Installer](https://imagej.net/plugins/javacv-installer), which must be installed in ImageJ (see Installation details below). |
| 25 | + |
| 26 | +## Usage |
| 27 | + |
| 28 | +***Import*** |
| 29 | + |
| 30 | +1. Select menu "Import Movie Using FFmpeg..." from the Import menu |
| 31 | +2. Specify the video file |
| 32 | +3. Configure import options in the user interface |
| 33 | + |
| 34 | +***Export*** |
| 35 | + |
| 36 | +1. Make required image stack active |
| 37 | +2. Select the Save As menu item - "Export Movie Using FFmpeg..." |
| 38 | +3. Customize export options in the user interface |
| 39 | +4. Specify the video file to save |
| 40 | + |
| 41 | +## Installation in Fiji |
| 42 | + |
| 43 | +Running the plugin requires installation of the [JavaCV installer](https://imagej.net/plugins/javacv-installer), which installs the interface for FFmpeg. |
| 44 | +Although you can install the JavaCV installer and then add FFmpeg manually as described in the JavaCV installer description, |
| 45 | +this is not necessary as the plugin will check for the availability of the required components and offer to download and install them automatically. |
| 46 | + |
| 47 | +Therefore, the following simple procedure is recommended: |
| 48 | +<ol> |
| 49 | + <li>Install the video plugin </li> |
| 50 | + <li>Run the import or export command, and the plugin will install everything by itself (several restarts of ImageJ will be required) </li> |
| 51 | +</ol> |
| 52 | + |
| 53 | +To install the video plugin: |
| 54 | +<ol> |
| 55 | + <li>add VideoImportExport update site https://sites.imagej.net/VideoImportExport/ using the update sites manager </li> |
| 56 | + <li>install the plugin normally using the updater </li> |
| 57 | +</ol> |
| 58 | + |
| 59 | + |
| 60 | +## Additional information and support |
| 61 | + |
| 62 | +The plugin is discussed at [imagej forum](https://forum.image.sc/t/plugins-for-reading-and-writing-compressed-video/8777) |
0 commit comments