---
name: "natsort"
section: "1"
platform: "linux"
package: "python3-natsort"
version: "8.0.2-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/natsort"
---

# natsort(1)

Natural sorting for shell

## NAME

natsort - Natural sorting for shell

## DESCRIPTION

usage: natsort \[-h\] \[--version\] \[-p\] \[-f LOW HIGH\] \[-F LOW HIGH\] \[-e EXCLUDE\]

-

  \[-r\] \[-t {int,float,real,f,i,r}\] \[--nosign\] \[-s\] \[--noexp\] \[-l\] \[entries ...\]

Performs a natural sort on entries given on the command-line.

Arguments are read from sys.argv.

### positional arguments:

- entries

  The entries to sort. Taken from stdin if nothing is given on the command line.

### options:

- **-h**, **--help**

  show this help message and exit

- **--version**

  show program's version number and exit

- **-p**, **--paths**

  Interpret the input as file paths. This is not strictly necessary to sort all file paths, but in cases where there are OS-generated file paths like "Folder/" and "Folder (1)/", this option is needed to make the paths sorted in the order you expect ("Folder/" before "Folder (1)/").

- **-f** LOW HIGH, **--filter** LOW HIGH

  Used for keeping only the entries that have a number falling in the given range.

- **-F** LOW HIGH, **--reverse-filter** LOW HIGH

  Used for excluding the entries that have a number falling in the given range.

- **-e** EXCLUDE, **--exclude** EXCLUDE

  Used to exclude an entry that contains a specific number.

- **-r**, **--reverse**

  Returns in reversed order.

- **-t** {int,float,real,f,i,r}, **--number-type** {int,float,real,f,i,r}, **--number\_type** {int,float,real,f,i,r}

  Choose the type of number to search for. "float" will search for floating-point numbers. "int" will only search for integers. "real" is a shortcut for "float" with **--sign**. "i" is a synonym for "int", "f" is a synonym for "float", and "r" is a synonym for "real".The default is int.

- **--nosign**

  Do not consider "+" or "-" as part of a number, i.e. do not take sign into consideration. This is the default.

- **-s**, **--sign**

  Consider "+" or "-" as part of a number, i.e. take sign into consideration. The default is unsigned.

- **--noexp**

  Do not consider an exponential as part of a number, i.e. 1e4, would be considered as 1, "e", and 4, not as 10000. This only effects the **--number-type**=*float*.

- **-l**, **--locale**

  Causes natsort to use locale-aware sorting. You will get the best results if you install PyICU.

## SEE ALSO

The full documentation for **natsort** is maintained as a Texinfo manual.  If the **info** and **natsort** programs are properly installed at your site, the command

-

  **info natsort**

should give you access to the complete manual.