mlpreview

• Previews files and directories in the terminal on Unix-likes.

• Can be used as a preview tool for lf file manager.

• OCaml port of crpreview.

Features

crpreview can preview the following formats:

File type	Tool
archives1	libarchive
images	Kitty unicode placeholders
pdf	libmupdf
videos	ffmpeg thumbnails
text	bat
directories	eza

Requirements

• If you want images: Terminal emulator that supports the kitty terminal graphics protocol

Installation

Nix

Try it out:

nix shell github:RisGar/mlpreview

Install it as a profile:

nix profile install github:RisGar/mlpreview

Include it in your config:

inputs={
...
mlpreview.url="github:RisGar/mlpreview";mlpreview.inputs.nixpkgs.follows="nixpkgs";};
...
environment.systemPackages=[mlpreview.packages.${pkgs.system}.default];

Manual

Ensure the following requirements are installed:

• OCaml 5.3
• libarchive
• mupdf
• bat
• eza
• ffmpeg

git clone https://github.com/RisGar/mlpreviewcd mlpreviewopam install . --deps-onlydune build

Usage

Add the following lines to your lfrc:

set previewer /path/to/mlpreview/bin/mlpreview
map i $ /path/to/mlpreview/bin/mlpreview $f | less -R

Make sure to install the required decompressors for libarchive to list archive contents.

Contributing

1. Fork it (https://github.com/RisGar/crpreview/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

Footnotes

1. Supported formats: tar, 7-zip, zip, bzip, bzip2, gunzip, xz, zstd, lzip↩