Video-2-Slit-Scan allows you to create a slit-scan image from a video. It provides a graphical interface for adjusting slit position and size. Video-2-Slit-Scan can support very large videos with modest RAM since it streams in the input video and writes out the output image to disk in chunks. Released for Windows and macOS (Mac/Apple/OS-X) as free software under the MIT license and makes use of FFmpeg binaries licensed under the GPU v3 see LICENSE.
slit-scan generated from Wellspring Fords video, 2017
- Download Video-2-Slit-Scan for Mac v0.2.6 Silicon or Video-2-Slit-Scan for Mac v0.2.6 Intel
- Double-click the downloaded file and drag the
Video-2-Slit-Scanicon to the Applications folder link
Intel version tested on macOS Sierra 10.12.6. Silicon version tests on macOS 12.6.3 on an Apple M1
- Download Video-2-Slit-Scan for Windows v0.2.6
Tested on Windows 11 x64
-
Download Video-2-Slit-Scan for Linux v0.2.6
-
Unzip file, cd into video-2-slit-scan subfolder, then from terminal run:
./video-2-slit-scan
Tested on Ubuntu 22.0.4.3 amd64
The latest release no longer has keyframing capabilities, please download release v0.2.4 or earlier if you need this feature.
- Launch the App
- Click
Open Video File, choose a video - Output file should get auto-populated, but if not, click
Set Output Fileto choose a save location - Click
Generate Slit-Scan Image, a slit-scan image with default settings will saved to your Desktop (or output file location)
- Given an input video, create a single output TIF (or PNG) grabbing a single vertical slice from each frame
- Adjust position and size of slit
- Manually adjust slit position as video plays (versions 0.2.4 and earlier only)
- Create moving slits over time by specifying slit position at keyframes and interpolating between keyframes over time (version 0.2.4 and earlier only)
- Performance. Video-2-Slit-Scan Should support very large input videos and very large output images. Videos are streamed in as needed, output images are not stored entirely in memory, but instead written to disk in small chunks (so you doo need sufficient disk space available). NOTE, that this allow previewing the output image in real-time using your OS image viewer during generation.
Slit-scan photography, imaging and cinematography have a long history in film and digitally. This app allows you to experiment with one particular slit-scan technique: digitally converting a video to a single ultra wide image. This app was originally commissioned by Jan Kubasiewicz who has created many beautiful works exploring various slit-scan techniques.
See also Strip photography for a more technical discussion on various techniques and history. Also known as streak images, streak photography, slit camera and slit scan camera.
- Install Java JDK 17+
- Install Eclipse 2023-06 (or later)
- run after-pull.sh
- Import Project Into Eclipse
- Create a new run configuration with Video2SlitScan set at the main class
Set JAVA_HOME environment variable to a Java JDK 17+ installation (so Gradle can run). All installers will be generated in the build directory. NOTE: the macOS installers open and edit GUI windows during the build so do not use your mouse or keyboard during the building process.
On Mac Silicon (M1/M2) run:
./gradlew createDmgArm
On Mac x64 (or Silicon with Rosetta) run:
./gradlew createDmgIntel
On Windows:
- Install https://jrsoftware.org/isinfo.php
- add C:\Program Files (x86)\Inno Setup 6 to your PATH environment variable
./gradlew createWindowsInstaller64
On Linux x64 run:
./gradlew createZipLinuxAmd64
NOTE: first download JDKs for the platform you are building on:
unzip to: jdk/jdk-17.0.8_macos-aarch64.jdk/Contents/Home
https://download.oracle.com/java/17/archive/jdk-17.0.8_linux-x64_bin.tar.gz
unzip to: jdk/jdk-17.0.8_macos-x64/Contents/Home
https://download.oracle.com/java/17/archive/jdk-17.0.8_macos-x64_bin.tar.gz
unzip to: jdk/jdk-17.0.8_windows-x64.jdk
https://download.oracle.com/java/17/archive/jdk-17.0.8_windows-x64_bin.zip
unzip to: jdk/jdk-17.0.8_linux-x64.jdk
https://download.oracle.com/java/17/archive/jdk-17.0.8_linux-x64_bin.tar.gz
To get additional JVM logging, launch Video-2-Slit-Scan from the Command Prompt:
video-2-slit-scan.exe
To get additional logging, control-click on application icon, click Show Package Contents, browse to Contents > MacOS and double-click JavaAppLauncher. Logging will show up in the Terminal window.
- Create PNG image 1024x1024
- Convert to iconset folder with Icon Generator
- Tweak individual icons if need be rename icons to Apple's latest scheme
- Rename folder to icon.iconset
- Convert to icns file with
iconutil -c icns -o icon.icns icon.iconsetthen copy into icon.icns into the doc/ directory
- Create PNG images (see windows docs for latest sizes), currently 16,32,48,256
- Convert to .ico using ImageMagick
convert icon-16.png icon-32.png icon-48.png icon-256.png icon.ico - Copy .ico file to doc/ directory