Skip to main content

`pls` is a prettier and powerful `ls` for the pros.

Project description

Python versions GPL-3.0 Platforms CI status LoC


pls on PyPI Docs

Demo of `pls` Help of `pls`

pls is a prettier and powerful ls for the pros.

The "p" stands for

  • pretty (the output from pls surely looks better)
  • powerful (pls has lots of features and endless customisation)
  • programmer (pls is geared towards developers)
  • professional (pls can be extensively tweaked by the pros)
  • Python (pls is written in Python!)

Just pick whichever helps you remember the command name.

It works in a manner similar to ls, in that it lists directories and files in a given directory, but it adds many more developer-friendly features.

⚠️ Note that pls is not a replacement for ls. ls is a tried, tested and trusted command with lots of features. pls, on the other hand, is a simple tool for people who just want to see the contents of their directories.


We have some very beautiful documentation over on our GitHub pages site. These docs are built from the docs branch in the same repository, and contributions to the docs are most welcome.

The docs contain information on almost everything, including but not limited to the following:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pls-6.0.0.tar.gz (54.0 kB view hashes)

Uploaded source

Built Distribution

pls-6.0.0-py3-none-any.whl (73.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page