git-lfs-smudge - Man Page

Git smudge filter that converts pointer in blobs to the actual content


git lfs smudge [path] git lfs smudge --skip [path]


Read a Git LFS pointer file from standard input and write the contents of the corresponding large file to standard output. If needed, download the file´s contents from the Git LFS endpoint. The path argument, if provided, is only used for a progress bar.

Smudge is typically run by Git´s smudge filter, configured by the repository´s Git attributes.


Without any options, git lfs smudge outputs the raw Git LFS content to standard output.


Skip automatic downloading of objects on clone or pull.


Disables the smudging process. For more, see: git-lfs-config(5).

Known Bugs

On Windows, Git does not handle files in the working tree larger than 4 gigabytes.

For more information, see:

See Also

git-lfs-install(1), gitattributes(5).

Part of the git-lfs(1) suite.

Referenced By

git-lfs(1), git-lfs-filter-process(1).

March 2021