.. image:: docs/_static/logo.png#gh-light-mode-only
   :align: center

.. image:: docs/_static/logo-dark.png#gh-dark-mode-only
   :align: center

`rmlint` finds space waste and other broken things on your filesystem and
offers to remove it.

.. image:: https://img.shields.io/github/v/release/sahib/rmlint?include_prereleases&display_name=release
   :target: https://github.com/sahib/rmlint/releases

.. image:: https://img.shields.io/github/commit-activity/m/sahib/rmlint/develop
   :target: https://github.com/sahib/rmlint/commits/develop/

.. image:: https://img.shields.io/github/issues/sahib/rmlint.svg
   :target: https://github.com/sahib/rmlint/issues

.. image:: https://img.shields.io/github/issues-pr/sahib/rmlint.svg
   :target: https://github.com/sahib/rmlint/pulls

.. image:: https://img.shields.io/github/license/sahib/rmlint.svg
   :target: https://www.gnu.org/licenses/quick-guide-gplv3.html

   .. raw:: html

      <br>

.. image:: https://github.com/sahib/rmlint/actions/workflows/linux.yaml/badge.svg
   :target: https://github.com/sahib/rmlint/actions/workflows/linux.yaml

.. image:: https://github.com/sahib/rmlint/actions/workflows/freebsd.yaml/badge.svg
   :target: https://github.com/sahib/rmlint/actions/workflows/freebsd.yaml

.. image:: https://github.com/sahib/rmlint/actions/workflows/macos.yaml/badge.svg
   :target: https://github.com/sahib/rmlint/actions/workflows/macos.yaml

.. image:: https://github.com/sahib/rmlint/actions/workflows/cygwin.yaml/badge.svg
   :target: https://github.com/sahib/rmlint/actions/workflows/cygwin.yaml

.. image:: https://app.readthedocs.org/projects/rmlint/badge/
   :target: https://rmlint.rtfd.org/

**Features:**

Finds…

- …Duplicate Files and duplicate directories.
- …Nonstripped binaries (i.e. binaries with debug symbols)
- …Broken symbolic links.
- …Empty files and directories.
- …Files with broken user or/and group ID.

**Differences to other duplicate finders:**

- Extremely fast (no exaggeration, we promise!)
- Paranoia mode for those who do not trust hashsums.
- Many output formats.
- No interactivity.
- Search for files only newer than a certain ``mtime``.
- Many ways to handle duplicates.
- Caching and replaying.
- `BTRFS` support.
- ...

It runs and compiles under most Unices, including Linux, FreeBSD, Darwin and Solaris.
The main target is Linux though, some optimisations might not be available
elsewhere.

.. image:: https://raw.githubusercontent.com/sahib/rmlint/develop/docs/_static/screenshot.png
   :align: center


INSTALLATION
------------

Chances are that you might have `rmlint` already as readily made package in
your favourite distribution. If not, you might consider
`compiling it from source <http://rmlint.readthedocs.org/en/latest/install.html>`_.


.. image:: https://repology.org/badge/vertical-allrepos/rmlint.svg?columns=5
   :align: center
   :target: https://repology.org/project/rmlint/versions

DOCUMENTATION
-------------

Detailed documentation is available on:

    http://rmlint.rtfd.org

Most features you'll ever need are covered in the tutorial:

    http://rmlint.rtfd.org/en/latest/tutorial.html

An online version of the manpage is available at:

    http://rmlint.rtfd.org/en/latest/rmlint.1.html

BUGS
----

If you found bugs, having trouble running `rmlint` or want to suggest new
features please `read this <http://rmlint.readthedocs.org/en/latest/developers.html>`_.

Also read the `BUGS <http://rmlint.readthedocs.org/en/latest/rmlint.1.html#bugs>`_ section of the `manpage <http://rmlint.rtfd.org/en/latest/rmlint.1.html>`_
to find out how to provide good debug information.

AUTHORS
-------

Here's a list of developers to blame:

=================== ============================== =========
*Christopher Pahl*   https://github.com/sahib      2010-2017
*Daniel Thomas*      https://github.com/SeeSpotRun 2014-2021
*Cebtenzzre*         https://github.com/Cebtenzzre 2021-2023
*Vassili Tchersky*   https://github.com/vassilit   2025-
=================== ============================== =========

There are some other people that helped us of course.
Please see the AUTHORS distributed along `rmlint`.

LICENSE
-------

`rmlint` is licensed under the conditions of the
`GPLv3 <https://www.gnu.org/licenses/quick-guide-gplv3.html.en>`_.
See the
`COPYING <https://raw.githubusercontent.com/sahib/rmlint/master/COPYING>`_
file distributed along the source for details.