Monochrome

What's Changed

🎉🎉🎉 Major new release, many new features:

* Added support for color (RGB or RGBA) videos
* Added native super quick TIFF file and TIFF image folder loader
* Added plugin system to load files/folders, dependencies will be automatically installed
* All new revised and improved UI
* Added native OS File/Folder picker support
* Added shortcuts for opening file/folder (`Ctrl + o`)

Supported File Formats

Monochrome supports a wide range of scientific image and video formats:

- **TIFF formats**: `.tif`, `.tiff`, `.ptif`, `.ptiff`, `.tf8`, `.lsm` (ZEISS LSM), `.btf`, `.bif` (Roche Digital Pathology), `.gel`, `.ndpi` (Hamamatsu Slide Scanner), `.stk`, `.qptiff` (Perkin Elmer Vectra)
- **Common images**: `.png`, `.jpg`, `.jpeg`, `.webp`, `.bmp`, `.pgm`
- **Scientific/Medical formats**: `.dcm`, `.dicom`, `.gdcm`, `.nii`, `.nii.gz`, `.mha`, `.mhd`, `.nrrd`, `.nhdr`, `.nia`, `.mgh`, `.mnc`, `.mnc2`, `.vtk`, `.gipl`, `.hdr`, `.ipl`, `.img`, `.img.nz`
- **Data formats**: `.mat`, `.npy`, `.dat`, `.hdf5`
- **Video formats**: `.mp4`, `.avi`, `.webm`, `.mov`, `.mkv`, `.gif`, `.wmv`, `.m4v`
- **MiCAM formats**: `.gsd`, `.gsh`, `.rsh`, `.rsm`, `.rsd`
- **Folders**: Directories containing TIFF, PNG, or DICOM files

**Full Changelog**: https://github.com/sitic/monochrome/compare/v2025.02.20...v2025.03.19

What's New?

* Bugfix release
* Added "turbo", "tab10", "cmocean:phase" colormaps
* Rearranged order of colormap in UI

**Full Changelog**: https://github.com/sitic/monochrome/compare/v2025.01.31...v2025.02.20

What's Changed
* Optical traces are now automatically loaded over the whole video in a background thread!
* Traces are shown while they are being computed
* Removed `--trace_length` and `--max_trace_length` command line arguments
* Added support for int8 and int16 numpy .npy files (in addition to uint8 and uint16)
* Automatically use opacity when adding a framediff overlay via GUI
* Updated and improved UI
* Added support for wayland on linux
* Updated dependencies

**Full Changelog**: https://github.com/sitic/monochrome/compare/v2025.01.17...v2025.01.31

What's New?

**PyPI Project Name Change:** The viewer is now available on PyPI as [`monochrome`](https://pypi.org/project/monochrome/). 🎉

I'm happy to announce that the project has officially moved to its new home on PyPI as monochrome! Thanks to a successful name transfer request, the old temporary monochrome-viewer name is now retired.

Upgrade Instructions

1. Uninstall the old `monochrome-viewer` package:
bash
pip uninstall monochrome-viewer

2. Install the new `monochrome` package:
bash
pip install monochrome

**Important Notes**

* The old `monochrome-viewer` package on PyPI is now deprecated and will no longer be maintained.
* Import statements in your code remain unchanged (`import monochrome`).

**Full Changelog**: https://github.com/sitic/monochrome/compare/v2024.12.02...v2025.01.17

* New API: `mc.export_video()` in Python to export a window to a .mp4 file as rendered with all layers/points/...
* New API: `mc.close_video()` in Python to close a video window
* New API: `mc.quit()` in Python will shutdown Monochrome instance
* [UI: Split trace export buttons into own tab](https://github.com/sitic/monochrome/commit/b7fb483347ac3a87fd1e59b64d77a3f4bba2618f)
* [UI: separate export video functions into own tab](https://github.com/sitic/monochrome/commit/60d2c2804e3069f40a031803a5a6d0d55275e4fe)
* CI and build fixes

**Full Changelog**: https://github.com/sitic/monochrome/compare/v2024.11.20...v2024.12.02

* UI: show filepath in metadata
* Python IPC: fix opacity value passing

**Full Changelog**: https://github.com/sitic/monochrome/compare/v2024.03.21...v2024.11.20