NATSORT(1)

✨ NATSORT(1) ✨

okay bestie, you're looking at the natsort manual page — that's the User Commands corner of the man pages, and yes, it's giving "natural sorting for shell" 💅 let's get into it.

---

🌸 NAME 🌸

natsort — natural sorting for shell 🐚✨

---

🦋 DESCRIPTION 🦋

so the usage is literally right here:

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 ...]

It performs a natural sort on the entries you hand it on the command-line. 🫶

Arguments are read from sys.argv.

---

🎀 positional arguments 🎀

• entries — the entries you want sorted, bestie. If you don't put anything on the command line, they get taken from stdin. no cap. 💖

---

💅 options 💅

• -h, --help — show this help message and then exit. classic. ✨
• --version — show the program's version number and exit. 👑
• -p, --paths — interpret the input as file paths. ngl, this isn't strictly necessary to sort all file paths, but when you've got OS-generated paths like "Folder/" and "Folder (1)/", you need this option so the paths come out in the order you actually expect — that's "Folder/" before "Folder (1)/". the way that matters 😭
• -f, --filter LOW HIGH — used for keeping only the entries that have a number falling in the given range. filtering era 🍓
• -F, --reverse-filter LOW HIGH — used for excluding the entries that have a number falling in the given range. opposite vibe, same energy 💀
• -e, --exclude EXCLUDE — used to exclude an entry that contains a specific number. bye bestie 👋
• -r, --reverse — returns in reversed order. main character flip 🔄
• -t, --number-type, --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. go read it, iykyk 📖✨

---

sign-off bestie 💖 this page is from natsort 8.4.0, dated January 2026, and it lives under NATSORT(1) in the User Commands section. slay, that's the whole page, periodt. 🎀🦋💅