How to install lsd on Ubuntu?

For Ubuntu 23.04 and later, use `apt install lsd`. For earlier versions, the snap is discontinued, so download binaries from the release page or install via cargo, as detailed in the README.

lsd vs exa: which should I use?

LSD excels with icon support and ls compatibility, while exa offers better metadata display and performance. Choose LSD if you want visual flair without leaving the ls command structure.

Why are icons not showing in my terminal with lsd?

Icons require a patched font like Nerd Fonts. Test with `echo $'\uf115'` to see if a folder icon displays; if not, check your terminal's font settings or reinstall fonts, per the troubleshooting guide.

How to configure custom colors in lsd?

Create a `colors.yaml` file in your config directory (e.g., ~/.config/lsd/) and define color schemes using the sample file as a reference, then use `lsd --config-file` to test changes.

Can lsd replace ls in all my scripts?

While LSD aims for compatibility, scripts parsing output might break due to colors and icons. Use `lsd --icon never` for plain text or stick to standard ls for critical automation.

How to enable tree view in lsd?

Use the `--tree` flag for a hierarchical display. For convenience, alias it in your shell config, e.g., `alias lt='lsd --tree'`, as suggested in the installation section.

lsd

Apache-2.0Rustv1.2.0

A modern, feature-rich rewrite of the GNU ls command with icons, colors, and tree view.

GitHub

15.9k stars498 forks0 contributors

What is lsd?

LSD (LSDeluxe) is a modern, feature-rich command-line file listing tool that reimagines the classic GNU `ls`. It enhances directory listings with visual improvements like icons, color coding, and tree views while maintaining compatibility with standard `ls` options and commands. It solves the problem of plain, monochrome terminal listings by providing a more informative and visually appealing way to browse files and directories.

Target Audience

System administrators, developers, and power users who frequently work in the terminal and want a more visually informative file listing experience without sacrificing the familiarity of `ls`. It is particularly suited for users who have patched fonts (like Nerd Fonts) installed and want to leverage icons in their terminal workflow.

Value Proposition

Developers choose LSD over standard `ls` or other alternatives for its extensive visual enhancements, including built-in icon support, syntax highlighting, and tree views, all while remaining a drop-in replacement that understands standard `ls` flags. Its unique selling point is combining the power and compatibility of GNU `ls` with modern, user-friendly features like YAML-based configuration for icons, colors, and behavior.

Overview

The next gen ls command

Use Cases

Best For

Related Projects

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub

Users seeking a visually enhanced, drop-in replacement for the GNU `ls` command with full flag compatibility.
Terminal users who want to display file type icons using patched fonts like Nerd Fonts or Font Awesome in their directory listings.
System administrators or developers who need a hierarchical tree view of directories for better visualization of complex folder structures.
Power users looking to extensively customize their terminal's file listing output through YAML configuration files for icons, colors, and formatting.
Cross-platform developers who need a consistent, modern file listing tool that works on Linux, macOS, Windows, and other Unix-like systems.
Users transitioning from projects like `colorls` who want a similar feature set in a tool explicitly designed as a modern `ls` rewrite.

Not Ideal For

Scripts or automated pipelines that parse `ls` output with plain text expectations, as LSD's color codes and icons can interfere with text processing.
Users on minimal or legacy terminal environments without Unicode or color support, where LSD's visual features will fail to render properly.
Teams with strict accessibility or consistency policies requiring monochromatic, icon-free terminal outputs for all users.

Pros & Cons

Pros

Rich Visual Enhancements

LSD adds syntax highlighting and file type icons using patched fonts, making directory listings more informative at a glance, as demonstrated by the colorful sample output in the README.

Drop-in ls Compatibility

It understands standard `ls` flags and can be aliased directly, allowing seamless replacement without learning new commands, as shown in the shell configuration examples.

Extensive Customization via YAML

Users can tailor icons, colors, and behavior through YAML configuration files, with sample files provided in the documentation folder for easy tweaking.

Broad Cross-Platform Support

LSD is packaged for Linux, macOS, Windows, and other Unix-like systems, with installation commands listed for numerous package managers in the README table.

Cons

Font Setup Complexity

Icon display requires patched fonts like Nerd Fonts, and the README includes extensive troubleshooting for icon issues, indicating a non-trivial setup that can break in many terminals.

Terminal Compatibility Issues

Known problems with terminals like Konsole (first character trimming) and PuTTY (icon rendering) require workarounds or configuration changes, as admitted in the F.A.Q. section.

Configuration Overhead

While customizable, managing multiple YAML files for icons, colors, and config adds complexity compared to simpler tools, and the documentation warns about testing changes before committing.

Frequently Asked Questions

Home

Command-Line Apps

Bat

A cat(1) clone with wings.

Stars58,484

Forks1,535

Last commit3 days ago

btop

A monitor of resources

Stars31,785

Forks987

Last commit10 days ago

exa

A modern replacement for ‘ls’.

Stars24,429

Forks658

Last commit1 year ago

eza

A modern alternative to ls

Stars21,435

Forks436

Last commit13 days ago

Command-Line Apps19.2k