https://github.com/EskelinenAntti/cdir

A faster way to navigate folders and browse files in Windows and Linux shells.
https://github.com/EskelinenAntti/cdir

bash browse-files cd command-prompt console-tool dir explorer file-manager files ls powershell programming-tools

Last synced: 3 months ago
JSON representation

A faster way to navigate folders and browse files in Windows and Linux shells.

• Host: GitHub
• URL: https://github.com/EskelinenAntti/cdir
• Owner: EskelinenAntti
• License: mit
• Created: 2019-08-20T19:53:07.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2023-01-19T18:04:12.000Z (almost 2 years ago)
• Last Synced: 2024-08-07T19:54:23.963Z (3 months ago)
• Topics: bash, browse-files, cd, command-prompt, console-tool, dir, explorer, file-manager, files, ls, powershell, programming-tools
• Language: Python
• Homepage:
• Size: 309 KB
• Stars: 27
• Watchers: 1
• Forks: 2
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• jimsghstars - EskelinenAntti/cdir - A faster way to navigate folders and browse files in Windows and Linux shells. (Python)

README

        
# CDIR

[![PyPI version](https://badge.fury.io/py/cdir.svg)](https://badge.fury.io/py/cdir)

This project exists because I felt that typing multiple `cd`, `dir`/`ls` commands and striking the tab-key is not very fast or pleasant way to navigate in shell. As developers often need to work in multiple environments, cdir supports bash shell, Windows Command Prompt and PowerShell. The core component of the project is implemented with python and uses curses module. Windows version uses [windows-curses](https://github.com/zephyrproject-rtos/windows-curses) module.

![cdir in action (gif)](doc/cdir.gif)

Discussion about cdir in [a Tecmint blog post](https://www.tecmint.com/cdir-navigate-folders-and-files-on-linux):

  *"Yes, fix something that is not broken."* -Linus Torvalds

  *"I agree with you. However, I just decided to try out the tool on CentOS 8 and see how it compares to running the ls and cd commands. Honestly, I like it."* -James Kiarie

   *"Some of the greatness innovations in the world have been realized by fixing the unbroken."* -Pat

See the actual discussion here https://www.tecmint.com/cdir-navigate-folders-and-files-on-linux/comment-page-1/#comment-1336160

#### Features

- Use arrow keys and enter to browse files.

- Modern and easy-to-use search functionality for folders: just start typing the name of the folder and folders are filtered by their name.

- Supports bash shell, Windows Command Prompt and PowerShell.

- Easy to install.

## Usage - Bash

1. Install with `pip install cdir`

2. Add following line to .bashrc:

```bash

alias cdir='source cdir.sh'

```

3. Type cdir and start browsing files and folders.

4. Press f1 to quit cdir.

## Usage - Windows Command Prompt

1. Install with `pip install cdir`

2. Type cdir and start browsing files and folders.

3. Press f1 to quit cdir.

## Contribution

Although there are no formal quidelines for contribution yet, it is warmly welcomed! Please use issues to discuss about changes/features you would like to make before implementing them.