Home

Awesome

<p align="center"> <a href="https://github.com/leo-arch/clifm"> <img src="misc/logo/clifm-banner.png" alt="CliFM logo"> </a> </p> <h2 align="center">The Command Line File Manager</h2> <h4 align="center">No GUI, no TUI, AND no menus. Just you and a powerful, file-management oriented command line.</h4> <h4 align="center"><a href="https://github.com/leo-arch/clifm/#floppy_disk-installation">Install</a> · <a href="https://github.com/leo-arch/clifm/wiki">Browse the documentation</a> · <a href="https://github.com/leo-arch/clifm/blob/master/.github/ISSUE_TEMPLATE/feature-request.md">Request feature</a> · <a href="https://github.com/leo-arch/clifm/issues">Report bug</a></h4>
<p align="center"> <a href="https://github.com/leo-arch/clifm/blob/master/LICENSE"><img src="https://img.shields.io/github/license/leo-arch/clifm?color=red&style=flat"/></a> <a href="https://github.com/leo-arch/clifm/releases"><img alt="GitHub release (latest by date)" src="https://img.shields.io/github/v/release/leo-arch/clifm"></a> <a><img src="https://img.shields.io/github/commits-since/leo-arch/clifm/latest"></a> <a><img src="https://img.shields.io/github/last-commit/leo-arch/clifm/master?color=blue&style=flat"/></a> <!--- <a href="https://en.wikipedia.org/wiki/Privacy-invasive_software"><img src="https://img.shields.io/badge/privacy-✓-green?style=flat"/></a> <a href="https://gitter.im/leo-arch/clifm"><img src="https://img.shields.io/gitter/room/leo-arch/clifm?style=flat"/></a> --> <a href="https://software.opensuse.org//download.html?project=home%3Aarchcrack&package=clifm"><img src="https://img.shields.io/badge/CD-OBS-red?logo=opensuse&logoColor=white"/></a> </p> <p align="center"> <a href="https://github.com/leo-arch/clifm/actions/workflows/codeql-analysis.yml"><img src="https://github.com/leo-arch/clifm/actions/workflows/codeql-analysis.yml/badge.svg?branch=master"></a> <a href="https://www.codacy.com/gh/leo-arch/clifm/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=leo-arch/clifm&amp;utm_campaign=Badge_Grade"><img src="https://app.codacy.com/project/badge/Grade/c2c24860fce64d2aa6ca8e1dd0981d6d"/></a> <a href="https://build.opensuse.org/package/show/home:archcrack/CliFM"><img src="https://build.opensuse.org/projects/home:archcrack/packages/CliFM/badge.svg?type=default"></a> <!--- <a href="https://app.codiga.io/project/30518/dashboard"><img alt="Code grade" src="https://api.codiga.io/project/30518/status/svg"/></a> --> <!--- <a href="https://bestpractices.coreinfrastructure.org/projects/4884"><img src="https://bestpractices.coreinfrastructure.org/projects/4884/badge"></a> --> </p>

demo

<!--- <h4 align="center">CliFM's interface</h4> <p align="center"><img src="https://i.postimg.cc/YC77qSLK/interface-1-7-9.png"></p> <p align="center">You only need 7 keystrokes to move all selected files into the <i>images</i> directory: <b>m sel 8</b></p> -->

:space_invader: Brief description

Clifm is a shell-like, text-based terminal file manager that sits on the command line.

Though fully-featured, powerful, and extensible, it is not so much about features, but about design, about the way in which you interact with your file system.

Most terminal file managers out there (if not all) are built using the TUI design principles, much like the superb Midnight Commander and Ranger. But clifm is built rather having the CLI design principles in mind: do not navigate through a big menu of files, just type it, exactly as you do in your regular shell, but easier and faster!

For this reason, clifm does not need to be better: it's just different! :wink:

For a detailed description consult the introductory section of our Wiki.

<!-- Unlike most terminal file managers out there, indeed, **clifm** replaces the traditional TUI interface (also known as curses or text-menu based interface) by a command-line interface (CLI),<sup>1</sup> also known as REPL.<sup>2</sup> If working with the command-line, your workflow is not affected at all, but just enriched with file management functionalities: automatic files listing, files selection, bookmarks, tags, directory jumper, directory and commands history, auto-cd and auto-open, bulk rename, TAB completion, autosuggestions, and a trash system, among [other features](#features). In this sense, **clifm** is certainly a file manager, but also a shell extension. Briefly put, with **clifm** the command-line is always already there, never hidden :godmode: :muscle: --- <sup>1</sup> <i>For more information about these concepts see the [resources page](https://github.com/leo-arch/clifm/wiki/Resources#gui-tui-and-cli) </i>. For a detailed description consult the [introductory section](https://github.com/leo-arch/clifm/wiki/Introduction#what-is-clifm) of our Wiki</i>. -->

:heavy_check_mark: Features

<details> <summary>Click here to expand</summary>

Besides common file operations such as copy, move, remove, etc., clifm provides the following features:

<h4 align="center"><br><i>Auto-suggestions in action</i></h4> <p align="center"><img src="https://i.postimg.cc/1XSKBRh8/suggestions.gif"></a></p>

For a detailed explanation of each of these features, follow the corresponding links or consult the Wiki.

</details>

:clapper: Introduction video

Alt text

<!--- <details> <summary>Watch me fly!</summary> <h3 align="center"><br><i>Did I say it's fast?</i></h3> <p align="center"><a href="https://mega.nz/embed/J8hEkCZZ#fGp0JtcDvFIWKmTc4cOp0iMrWRlbqs99THg8F7EmQWI"><img src="https://i.postimg.cc/CKx6zrvL/vid-thumb.png"></a></p> Music: "Quad Machine", by [Sonic Mayhem](https://en.wikipedia.org/wiki/Sascha_Dikiciyan) \ **Note**: Icons and files preview depend on third-party software. Consult the [icons](https://github.com/leo-arch/clifm/wiki/Advanced#icons-smirk) and [files preview](https://github.com/leo-arch/clifm/wiki/Advanced#files-preview) sections. </details> -->

:floppy_disk: Installation

From a package manager

<details> <summary>Packaging status <a href="https://repology.org/project/clifm/versions"><img src="https://repology.org/badge/tiny-repos/clifm.svg" alt="Packaging status"></a></summary> <a href="https://repology.org/project/clifm/versions"> <img src="https://repology.org/badge/vertical-allrepos/clifm.svg?columns=3" alt="Packaging status"> </a> </details>

If running on Linux, binary packages are available for most major distributions via the OpenSUSE Build System.

From source (Linux/BSD)

Note: Dependencies are most likely already satisfied, but in any case consult the dependencies section.

git clone https://github.com/leo-arch/clifm.git
cd clifm
sudo make install

For more information/supported platforms consult the installation page.


:bulb: Getting started

To start using clifm you don't need to learn anything new: the usual shell commands will just work. However, there is much more than just shell commands...
✓ The help command gives you a quick introduction to clifm: once in the clifm prompt, enter help or ?.
✓ Type cmd<TAB> to get the list of available commands and a brief description.
✓ Type help <TAB> to get the list of available help topics. Select the one you want and press <kbd>Enter</kbd>.
✓ To jump into the COMMANDS section in the manpage, simply enter cmd or press <kbd>F2</kbd>.
✓ Press <kbd>F1</kbd> to access the full manpage and <kbd>F3</kbd> to access the keybindings help-page.
✓ To get help about some specific command just type CMD -h. For instance, s -h.

You can also take a look at some of both our FAQ and these basic usage-examples to get you started.
For a complete description please consult our Wiki.


:newspaper: What's new?

<details> <summary>Click here to expand</summary> </details>

For more details consult the changelog file.


Support

Clifm runs on Linux, Termux (Android), FreeBSD, NetBSD, OpenBSD, DragonFly, MacOS, Solaris/Illumos, Haiku, and Cygwin/MinGW, on x86, ARM, PowerPC, and RISC-V architectures.


License

This project is licensed GPL version 2 (or later). See the LICENSE file for details.


Contributing

Contributions are kindly welcome! Please see our contribution guidelines for details.


Community

<!--- Join our [Gitter discussion room](https://gitter.im/leo-arch/clifm) and let us know what you think: ideas, comments, observations and questions are always useful. -->

Visit the Discussions section of this repo and let us know what you think: ideas, comments, observations and questions are always useful.


Developer

Leo Abramovich <leo.clifm@outlook.com>.

Special thanks to all those who have contributed to this project.