..  _introduction:

============
Introduction
============

..  _what-it-does:

What does it do?
================

**Find it. Fix it. Never rm -rf a client's fileadmin by accident.**

Filefix is a TYPO3 backend extension that keeps :file:`fileadmin` honest.
Real-world :file:`fileadmin` folders rot in a few specific ways:

#.  **Content/extension mismatches.** Someone renames a :file:`.png` to
    :file:`.jpg`, or an old CMS re-exported a Photoshop file as :file:`.jpg`
    without converting it. The browser silently mis-renders it, or breaks
    entirely.
#.  **Unused files pile up.** Thousands of uploads that no page, no content
    element and no FlexForm references anymore.
#.  **The same file, uploaded again and again.** Identical content under
    different names and folders, each copy taking its own disk space and
    metadata.
#.  **Camera-original images.** 6000 px wide, 8 MB JPEGs uploaded straight from
    the camera, for a slot that never renders wider than 1900 px.

Filefix addresses all of these with purpose-built tools that live where editors
already work:

*   :ref:`MIME Fix <usage-mimefix>` inside the native file list
*   :ref:`File Cleanup <usage-cleanup>` for unreferenced files
*   :ref:`Duplicate report <usage-duplicates>` with a deep usage check
*   :ref:`Oversized images <usage-oversized>` report with in-place resize
*   :ref:`Dashboard widgets <usage-dashboard>` showing unused files and space