eskelinenantti / cdir

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

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

Discussion about cdir in a Tecmint blog post:

"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:

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.

cdir's Issues

Cannot install on debian

Traceback (most recent call last): File "/usr/local/bin/pip3", line 5, in <module> from pip._internal.cli.main import main File "/home/dietpi/.local/lib/python3.9/site-packages/pip/_internal/cli/main.py", line 9, in <module> from pip._internal.cli.autocompletion import autocomplete File "/home/dietpi/.local/lib/python3.9/site-packages/pip/_internal/cli/autocompletion.py", line 10, in <module> from pip._internal.cli.main_parser import create_main_parser File "/home/dietpi/.local/lib/python3.9/site-packages/pip/_internal/cli/main_parser.py", line 8, in <module> from pip._internal.cli import cmdoptions File "/home/dietpi/.local/lib/python3.9/site-packages/pip/_internal/cli/cmdoptions.py", line 23, in <module> from pip._internal.cli.parser import ConfigOptionParser File "/home/dietpi/.local/lib/python3.9/site-packages/pip/_internal/cli/parser.py", line 12, in <module> from pip._internal.configuration import Configuration, ConfigurationError File "/home/dietpi/.local/lib/python3.9/site-packages/pip/_internal/configuration.py", line 26, in <module> from pip._internal.utils.logging import getLogger File "/home/dietpi/.local/lib/python3.9/site-packages/pip/_internal/utils/logging.py", line 27, in <module> from pip._internal.utils.misc import ensure_dir File "/home/dietpi/.local/lib/python3.9/site-packages/pip/_internal/utils/misc.py", line 39, in <module> from pip._internal.locations import get_major_minor_version File "/home/dietpi/.local/lib/python3.9/site-packages/pip/_internal/locations/__init__.py", line 14, in <module> from . import _distutils, _sysconfig File "/home/dietpi/.local/lib/python3.9/site-packages/pip/_internal/locations/_distutils.py", line 9, in <module> from distutils.cmd import Command as DistutilsCommand ModuleNotFoundError: No module named 'distutils.cmd'
Regards

Cdir cannot run on Windows 11

bug: where is cdir.sh?

bug when source cdir.sh

cdir is not running on Windows 11

Hi @EskelinenAntti 👋

As the title says. I have downloaded and installed the latest version of Python (3.12.0), then I open Windows Terminal and type the command pip install cdir. Cdir installs without problem and without errors, but then when I type cdir to start using it, the error that you can see in the image appears.

This same error also appears in PowerShell. Please, you can fix it?