Skip to content

Latest commit

 

History

History
107 lines (81 loc) · 3.86 KB

README.md

File metadata and controls

107 lines (81 loc) · 3.86 KB
Raw

📺 NTSC-VHS Renderer

Intuitive rendering and GUI for LMP88959/NTSC-CRT with effects

YouTube Bandcamp Spotify SoundCloud

Jerobeam Fenderson - Shrooms through NTSC-VHS-Renderer (NTSC, Interlaced, Brightness +100, Contrast +10, Bloom 80)

Corpse Bride ending through NTSC-VHS-Renderer (VHS, Interlaced, Brightness +20, Contrast +10, Bloom 45)

📙 Dependencies

❓ Get started

Note: At the moment, compiled releases are only available for Windows x64. To run on another platform, you must build the project from source yourself (see 🔨 Building from source section)

  1. Download latest release from https://github.com/F33RNI/NTSC-VHS-Renderer/releases/latest
  2. Unzip it and run NTSC-VHS-Renderer-X.X.X-Windows-AMD64.exe
  3. Open a video or image file by dragging it to the GUI or by clicking "File" -> "Open"
  4. On "Render" tab change whatever you want. To render to a file, click the "Render and Save as" button
  5. Enjoy!

🔨 Building from source

  1. Install CMake, Python and other basic building tools

  2. Build NTSC-CRT for your system

    Windows example:

    git clone https://github.com/LMP88959/NTSC-CRT
cd NTSC-CRT
cmake -B build -DLIVE=off -DVIDEO=on -DCRT_SYSTEM=5
cmake --build build --config Release
move build\Release\ntsc_video.exe build\Release\ntsc_video_vhs.exe
cmake -B build -DLIVE=off -DVIDEO=on -DCRT_SYSTEM=0
cmake --build build --config Release

  3. Download FFmpeg binaries from https://ffmpeg.org/download.html or build them by yourself. NTSC-VHS Renderer uses ffmpeg and ffprobe files

  4. Download BloomEffect source code from https://github.com/yoyoberenguer/BloomEffect/tree/version-1.0.2/BloomEffect

  5. Clone NTSC-VHS Renderer repo:

    git clone https://github.com/F33RNI/NTSC-VHS-Renderer
cd NTSC-VHS-Renderer

  6. Create virtual environment and install requirements:

    Windows example:

    python -m venv venv
venv/Scripts/activate
pip install -r requirements.txt

  7. Copy NTSC-CRT binaries (ntsc_video and ntsc_video_vhs), ffmpeg binaries (ffmpeg and ffprobe) and BloomEffect source code (into bloom directory: NTSC-VHS-Renderer/bloom/...)

  8. To start NTSC-VHS-Renderer: run python main.py

  9. To build executable: run pyinstaller NTSC-VHS-Renderer.spec. Output files and executable will be in dist/NTSC-VHS-Renderer-VERSION-PLATFORM directory

📝 TODO

  • Fix output resolution (probably caused by NTSC-CRT)
  • Test properly
  • Build for linux
  • Make it faster
  • Add rolling shutter effect

✨ Contribution

  • Anyone can contribute! Just create a pull request

🚧 P.S. This project is under development!