Count Files

A command-line interface (CLI) utility written in Python to help you count files, grouped by extension, in a directory.

By default, it will count files recursively in current working directory and all of its subdirectories, and will display a table showing the frequency for each file extension (e.g.: .txt, .py, .html, .css) and the total number of files found.

Main functions:

  • counting files by extension and sorting results by frequency or alphabetically;
  • file searching by extension, additionally: file sizes, preview for text files;
  • total counting of all files or files with a specific extension.


  • counting or searching files with a specific extension, files without an extension, all files regardless of the extension;
  • recursive and non-recursive counting or searching;
  • an option to include or exclude hidden files and folders while searching or counting;
  • an option to process the file extensions with case-sensitive or case-insensitive mode;
  • an option to turn off the program’s operating indicator (feedback).

Supported operating systems:

Linux, macOS, Windows.

It may also be used on iOS (iPhone/iPad) using the StaSh command-line in the Pythonista 3 app.

Supported Python versions:

Python 3.6 and later


  • Linux Mint 19 “Tara”, Python 3.6.5
  • Windows 8.1 Professional, Python 3.6.0
  • macOS 10.13.6 High Sierra, Python 3.7.0
  • macOS 10.13.6 High Sierra, Python 3.6.6
  • macOS 12.12.6 Sierra, Python 3.7.0
  • macOS 12.12.6 Sierra, Python 3.6.6
  • macOS 12.11.6 El Capitan, Python 3.7.0
  • macOS 12.11.6 El Capitan, Python 3.6.6
  • iOS 12.0 (Pythonista 3.2), Python 3.6.1
  • iOS 9.3.5 (Pythonista 3.2), Python 3.6.1

License: MIT

Source on GitHub: Project repository


Did you find a bug or do you have a suggestion?

Please, open a new issue or a pull request to the repository.