How to use

CLI arguments

Arguments can be specified in both short and long form. For example: -a or --all.

usage: count-files [-h] [-v] [-st] [-a]
                   [-c] [-nr] [-nf]
                   [-t TOTAL] [-alpha]
                   [-fe FILE_EXTENSION] [-fs]
                   [-p] [-ps PREVIEW_SIZE] [path]


usage: count-files [--help] [--version] [--supported-types] [--all]
                   [--case-sensitive] [--no-recursion] [--no-feedback]
                   [--total TOTAL] [--sort-alpha]
                   [--file-extension FILE_EXTENSION] [--file-sizes]
                   [--preview] [--preview-size PREVIEW_SIZE] [path]

Common arguments

path, --all, --case-sensitive, --no-recursion, --no-feedback

Special arguments

  • File counting by extension (sorted table):
    --sort-alpha
  • File searching by extension (list with file paths):
    --file-extension, --file-sizes, --preview, --preview-size
  • Total number of files (number):
    --total

Getting help

To check the list of available options and their usage, you just need to use one of the following commands:

count-files -h

count-files --help

Check the version number of the program:

count-files -v

count-files --version

Get the list of currently supported file types for preview:

count-files -st

count-files --supported-types

The path argument

Optionally, you can pass it a path to the directory to scan. If you prefer, you can leave that argument empty, and it will scan the current working directory.

To process files in the user’s home directory, you can use ~ (tilde).

If there are spaces in the folder names, then path should be specified in quotation marks. For example, in Windows: count-files "~\Desktop\New folder"

Non-recursive search or counting

The optional -nr or --no-recursion switch argument tells the application not to scan recursively through the subdirectories.

Hidden files and directories

By default, it will ignore files and directories that are supposed to be hidden, but you can add the -a or --all optional switch argument to make it count or search for all files.

In Windows, files and directories considered hidden by this application are those for which the FILE_ATTRIBUTE_HIDDEN attribute is set to true.

In Linux, macOS, iOS and other Unix-like operating systems, a file or directory is considered to be hidden if its name starts with a . (dot).

Case sensitivity

The names of extensions are case insensitive by default. The results for ini and INI will be the same. To distinguish between similar extensions in different cases, use the -c or --case-sensitive switch argument.

  • File counting by extension (sorted table):

    In this case, the file extensions in the table will be displayed as is (in lowercase and uppercase).

  • File searching by extension (using -fe or --file-extension):

    The result of the search will be a list with paths to files with an extension in the corresponding register.

  • Total number of files (using -t or --total):

    For total counting of files with a specific extension, this option is also available.

Customizing operation feedback

By default, the program displays an operating indicator that consists in successively printing processed file names in a single line. File names are not displayed, however, when searching for a particular extension, if there are no such files in the folder or if the files are hidden, and the argument --all was not specified.

This kind of feedback is available by default when counting files by extension and when counting the total number of files (using -t or --total). The optional -nf or --no-feedback switch argument disables it.

Using the --no-feedback argument allows you to speed up a little the processing of a large amount of files/folders.

When searching for files by extension (using -fe or --file-extension) the feedback mechanism is the list of file paths itself.

File counting by extension

To count all files by extension, you can simply use the command count-files and, if necessary, specify one or more of the common arguments: path, --all, case-sensitive, --no-recursion, --no-feedback.

The --sort-alpha argument

By default, result of file counting by extension is a table that lists all the file extensions found and displays the frequency for each file extension. To sort the extensions alphabetically, use the -alpha or --sort-alpha argument.

File searching by extension

Another main feature of this application consists in searching files by a given extension, which presents to the user a list of all found files.

Using -fe or --file-extension argument, you can find all the files that have the specified extension.

Total counting of files

To count the total number of files, the number of files with a specific extension or the number of files without any extension you can use the -t or --total argument and specify the name of the extension.

Preview text files

Preview is available as an option when searching files using the -fe or --file-extension argument.

The default text preview size depends on the terminal width settings. You can change this value by specifying the argument -ps or --preview-size followed by an integer (the number of characters to display from each file).

Example: count-files --file-extension css --preview --preview-size 50

File sizes

You can get additional information about the size of each file using the -fs or --file-sizes argument. This option is only available when searching files using the -fe or --file-extension argument.

Example: count-files --file-extension js --file-sizes